Skip to content
Work IQ Dev Tools are in preview (v0.26.0). Commands and APIs may change before 1.0. See the installation guide.

Command reference

This page lists every wiqd command with its synopsis, options, and a few example invocations. It mirrors the default wiqd --help surface — the host commands plus the bundled extensions that are active out of the box. Each command notes the extension that contributes it.

Exit codes are not repeated per command. Every wiqd command follows the standard convention:

CodeMeaning
0Success
1User or upstream error (bad input, tool failure, postcondition failure)
2Configuration or infrastructure error (binary missing, version mismatch, not a project, or a required provider definitively reports signed out)
130Cancelled (Ctrl+C)

See Exit codes & output for the full contract.

Copilot and Claude plugins are managed by their native marketplaces, independently of WIQD CLI installation and extension activation. See marketplace installation. WIQD does not compose, refresh, or remove a host plugin. Managed extension CLIs remain available through normal first-use resolution and wiqd doctor.

Before changing a failing installation, collect its existing local state:

Terminal window
wiqd diagnostics collect --output ./incident.json.gz --json
wiqd diagnostics collect --output ./incident-with-log.json.gz --log ./incident.ndjson

The output directory must already exist, and existing destinations are never overwritten. Collection needs neither sign-in nor EULA acceptance. It does not run health checks, execute upstream tools, repair the installation, change configuration, send telemetry, or upload evidence.

The gzip JSON archive contains runtime/OS versions and architecture, installation fingerprints without absolute paths, registered extension participation and available managed-tool metadata. It omits credentials, configuration contents, environment values, project/customer content, plugin/VSIX inventory and installer history. Optional logs must be selected explicitly (up to four regular files); only typed timestamps, levels, exit/HTTP codes and redacted correlation markers are retained. Messages, stacks and arbitrary fields are excluded. Each log is limited to its last 64 KiB, 100 records and the preceding two hours.

Acquisition has a 10-second budget; both uncompressed JSON and the archive are limited to 1 MiB. Output is private to the current user (POSIX mode 0600 or a protected Windows DACL); filesystems unable to protect or exclusively publish the file fail explicitly. Ctrl+C cancels collection. Exit 0 means an archive was written, not that the installation is healthy. Inspect partial, each source’s status, errors, omissions and truncated before interpreting missing evidence. If the CLI or runtime cannot start, retain manual version and component intake.

Review and redact the archive before sharing. Transfer it only through your organization’s approved restricted incident channel and follow its retention policy; do not attach it to public issues or paste raw content into chat.

These options are accepted by every command and are omitted from the per-command tables below.

OptionDescription
-v, --versionOutput the version number and exit
--jsonEmit machine-readable JSON output (default is a human-readable table) (default: false)
--verboseShow verbose output (default: false)
--no-bannerSuppress the ASCII art banner
--account <email>Global account hint; provider-specific account selection is not implemented
--log-level <level>Set logging level (choices: “trace”, “debug”, “info”, “warning”, “error”, “critical”, “none”)
--log-format <format>Set log output format (choices: “json”, “text”)
-h, --helpdisplay help for command

wiqd agent

CommandExtensionDescription
wiqd agentwiqd (core)Configure embedded agents and inspect deployed declarative agents
wiqd agent addwiqd CoreAugment an existing declarative agent with an action, skill, or auth config.
wiqd agent add actionwiqd CoreAdd an OpenAPI or remote MCP action to a declarative agent.
wiqd agent add authwiqd CoreAdd an auth configuration to a plugin manifest.
wiqd agent add skillwiqd CoreAdd a skill to a declarative agent.
wiqd agent evalCopilot EvalRun quality evaluations against a deployed declarative agent.
wiqd agent eval initCopilot EvalInitialize an evaluation prompts.json for a project (drops a fixed seven-item bootstrap for the default declarative-agent template, plus env/.env..user from your Azure OpenAI / tenant env vars). This is not manifest-aware count-based generation.
wiqd agent infowiqd CoreShow MOS3 launch / acquisition info for a deployed agent. Accepts —agent-id (e.g. P_xxx.declarativeAgent), —title-id, or —manifest-id; emits the raw launch-info JSON. Used by the DevUI portal. Requires Microsoft 365 sign-in; use wiqd auth login --interactive.
wiqd agent listWork IQList declarative agents deployed in the tenant.
wiqd agent monitorWork IQQuery the Insights Agent about a provisioned agent’s performance and usage.
wiqd agent showWork IQRetrieve the real Work IQ A2A agent card by deployed agent ID or name.

wiqd auth

CommandExtensionDescription
wiqd authwiqd (core)Manage authentication for wiqd and its extensions
wiqd auth loginwiqd (core)Sign in to all active auth providers (requires a terminal)
wiqd auth logoutwiqd (core)Sign out of wiqd services
wiqd auth statuswiqd (core)Show authentication status
wiqd auth tokenwiqd Coretoken
wiqd auth token getwiqd CoreInteractively obtain and deliberately reveal a delegated Microsoft 365 refresh token for caller-managed CI lifecycle authentication. Requires a local terminal; no project or prior login needed.

wiqd changelog

CommandExtensionDescription
wiqd changelogwiqd (core)Show wiqd release changelog

wiqd completion

CommandExtensionDescription
wiqd completionwiqd (core)Output a shell tab-completion script (bash, zsh, powershell, fish)

wiqd component

CommandExtensionDescription
wiqd componentwiqd (core)Manage the Work IQ VS Code extension
wiqd component vscodewiqd (core)Manage the Work IQ VS Code extension
wiqd component vscode infowiqd (core)Report the VS Code extension install location (stable + insiders)
wiqd component vscode installwiqd (core)Install the VS Code extension
wiqd component vscode uninstallwiqd (core)Uninstall the VS Code extension

wiqd config

CommandExtensionDescription
wiqd configwiqd (core)Manage wiqd configuration settings
wiqd config flagswiqd (core)Manage wiqd feature flags
wiqd config flags listwiqd (core)List all registered feature flags and their resolved values
wiqd config flags resetwiqd (core)Clear a persisted feature flag value
wiqd config flags setwiqd (core)Persist a feature flag value
wiqd config flags showwiqd (core)Show definition and resolved value for a single feature flag
wiqd config resetwiqd (core)Reset all configuration to defaults
wiqd config setwiqd (core)Set configuration values

wiqd connector

CommandExtensionDescription
wiqd connectorwiqd (core)Discover catalog connectors and create MCP or REST API connectors
wiqd connector addwiqd CoreCreate a connector for a remote MCP server or Swagger 2.0 REST API through production MCP Platform.
wiqd connector listwiqd CoreDiscover remote MCP and preview OpenAPI connectors from the Microsoft 365 catalog.
wiqd connector showwiqd CoreShow a canonical catalog agentConnector node.

wiqd devui

CommandExtensionDescription
wiqd devuiwiqd (core)Launch the local Work IQ DevUI web experience
wiqd devui askWork IQ DevUIAsk an agent and watch the turn run live in the local Work IQ DevUI (deep-linked + auto-sent).
wiqd devui configWork IQ DevUIConfigure DevUI to mint access tokens with your own Entra app registration (skip the workiq CLI). Running start afterwards forces an initial sign-in.
wiqd devui startWork IQ DevUIStart (or reuse) the local Work IQ DevUI and open it in the browser.
wiqd devui stopWork IQ DevUIStop the running local Work IQ DevUI (release its server and the install-directory lock).

wiqd diagnostics

CommandExtensionDescription
wiqd diagnosticswiqd (core)Collect local diagnostics without changing the installation
wiqd diagnostics collectwiqd (core)Write a private, read-only diagnostic evidence archive

wiqd doctor

CommandExtensionDescription
wiqd doctorwiqd (core)Check environment health (Node.js, extensions, auth)

wiqd eula

CommandExtensionDescription
wiqd eulawiqd (core)Accept or report WIQD and downstream-tool End User License Agreements (EULAs)
wiqd eula acceptwiqd (core)Accept one tool’s EULA through the human-confirmed acceptance path
wiqd eula statuswiqd (core)Report EULA-acceptance state for all EULA-gated tools

wiqd exec

CommandExtensionDescription
wiqd execwiqd (core)Run an extension-managed CLI (e.g. workiq) with args forwarded verbatim (use -- <flags> to forward flags that collide with wiqd globals)

wiqd ext

CommandExtensionDescription
wiqd extwiqd (core)Manage installed wiqd extensions
wiqd ext addwiqd (core)Activate an installed extension (registers it in ~/.wiqd/extensions.json)
wiqd ext listwiqd (core)List discovered and registered extensions
wiqd ext removewiqd (core)Deactivate an extension (removes it from ~/.wiqd/extensions.json)
wiqd ext showwiqd (core)Show extension details

wiqd feedback

CommandExtensionDescription
wiqd feedbackwiqd (core)List and submit feedback about wiqd
wiqd feedback listGitHubList feedback you submitted through wiqd.
wiqd feedback submitGitHubSubmit feedback about wiqd as a GitHub issue.

wiqd marketplace

CommandExtensionDescription
wiqd marketplacewiqd (core)Install the public WIQD plugin through a supported host’s native marketplace.
wiqd marketplace setupwiqd CoreInstall the public wiqd@wiqd plugin from microsoft/wiqd, or keep a verified existing public Copilot installation. This does not configure your complete WIQD environment.

wiqd plugin

CommandExtensionDescription
wiqd pluginwiqd (core)Build, validate, package, and publish standalone plugins (agent + skills + connector)
wiqd plugin addwiqd Coreadd
wiqd plugin add agentwiqd CoreCompose one declarative agent into an existing plugin without replacing plugin-owned files.
wiqd plugin add collaboratorwiqd CoreAdd and read-back verify one M365 plugin title co-owner.
wiqd plugin add connectorwiqd CoreAdd a catalog connector (—selector), a remote MCP connector, or an OpenAPI custom connector to the plugin manifest.
wiqd plugin add environmentwiqd CoreCopy an existing plugin environment to a new name.
wiqd plugin add market-listingValidation & LSPSave .validate/listing.json with approved publishing-only details. Replaces the whole listing; use ‘wiqd plugin preview market-listing’ afterward for HTML confirmation. Does not validate or publish.
wiqd plugin add skillwiqd CoreScaffold a SKILL.md skill folder and register it in the plugin manifest.
wiqd plugin askWork IQSend a message directly to a declarative agent component.
wiqd plugin createwiqd CoreScaffold a new, empty standalone plugin project from the built-in blank app template.
wiqd plugin deletewiqd CoreDelete a plugin’s provisioned cloud resources. Either by env (project-based) or by —title-id (works for any plugin you can administer, no local project required). Requires Microsoft 365 sign-in; use wiqd auth login --interactive.
wiqd plugin exportwiqd CoreExport a plugin project to Open Plugin (or Claude/Cursor) format.
wiqd plugin getValidation & LSPGet plugin resources.
wiqd plugin get market-listingValidation & LSPRead .validate/listing.json and check any supported schema, including 1.0. Missing files return 404; invalid listings fail explicitly. No policy or media checks.
wiqd plugin importwiqd CoreImport an Open Plugin (or Claude/Cursor plugin) as a new plugin project.
wiqd plugin listwiqd CoreList standalone plugin projects under a directory.
wiqd plugin list collaboratorswiqd CoreList verified co-owners for the selected M365 plugin title, including standalone plugins.
wiqd plugin list environmentswiqd CoreList environments from the lifecycle-configured environment folder.
wiqd plugin list templateswiqd CoreList supported templates for ‘wiqd plugin add agent’.
wiqd plugin packagewiqd CorePackage the plugin into a .zip. Use —offline for a local-only preview connector/skill package without provisioning or server validation.
wiqd plugin previewValidation & LSPPreview plugin resources.
wiqd plugin preview market-listingValidation & LSPGenerate a read-only HTML review of an existing valid listing and its local media. Supports legacy listings without recollection; no package, AI or validation execution.
wiqd plugin provisionwiqd CoreProvision a plugin to an environment after validating bundled DA skill and Worker references. Requires Microsoft 365 sign-in; use wiqd auth login --interactive.
wiqd plugin provision packagewiqd CorePrepare or personally sideload a final DA or supported MCP connector ZIP without a source project.
wiqd plugin publishwiqd CoreSubmit a provisioned plugin to the tenant organization app catalog for administrator approval. Requires Microsoft 365 sign-in; use wiqd auth login --interactive.
wiqd plugin removewiqd CoreRemove plugin access.
wiqd plugin remove accesswiqd CoreRemove plugin usage or existing shared-access grants. This is not title co-owner removal.
wiqd plugin repairValidation & LSPRepair plugin artifacts.
wiqd plugin repair packageValidation & LSPApply explicit hash-bound replacements to a new ZIP without a source project. Preserves the original; does not validate or publish.
wiqd plugin resetwiqd CoreReset plugin state.
wiqd plugin reset environmentwiqd CoreReset a plugin environment and its optional .user sidecar.
wiqd plugin sharewiqd CoreShare a plugin with users or the entire tenant. Requires Microsoft 365 sign-in; use wiqd auth login --interactive.
wiqd plugin showwiqd CoreShow complete offline details for a local plugin and its optional embedded agent.
wiqd plugin validateValidation & LSPValidate plugin source offline, a final package with TDP (default), or package and Marketplace readiness. Package/Marketplace upload the ZIP and may require Core sign-in.

wiqd policy

CommandExtensionDescription
wiqd policywiqd (core)Work IQ maker-policy operations
wiqd policy publishwiqd CorePublish Work IQ policy for an existing title through the native SDK. Requires a compatible SDK and prior Microsoft 365 sign-in.

wiqd publish

CommandExtensionDescription
wiqd publishwiqd (core)Publish prepared packages to a registry or marketplace
wiqd publish pcPartner Center Publishing FoundationRun the real preflight, Draft preparation, and submission flow in order. Requires —interactive with separate typed submission authorization, or —authorize-submit for unattended submission; Draft confirmation is supplied internally to the composed preparation stage.
wiqd publish pc accessPartner Center Publishing FoundationShow static Marketplace publisher setup guidance; WIQD cannot verify publishing readiness at this time.
wiqd publish pc initPartner Center Publishing FoundationScaffold or read partner-center.json for this project; optionally verifies —product-id against the real Product.
wiqd publish pc preflightPartner Center Publishing FoundationRead the real Product/resource-tree and classify the proposed change (listing-only vs. package/version impact).
wiqd publish pc preparePartner Center Publishing FoundationCreate/update the real Draft: configure listing fields, upload package/assets via MCP, and record the Product ID locally.
wiqd publish pc resumePartner Center Publishing FoundationShow a synthetic resume result; no operation is read, reconciled, or continued.
wiqd publish pc statusPartner Center Publishing FoundationRead real job/submission/resource-tree state for the selected Product or configure job.
wiqd publish pc submitPartner Center Publishing FoundationSubmit a prepared Draft for certification. Requires —yes AND either —interactive with typed confirmation at a real terminal or —authorize-submit for unattended authorization. Re-verifies the exact prepared Draft before dispatch.
wiqd publish pc updatePartner Center Publishing FoundationPreview or apply selected listing fields, package changes and media to the offer bound in partner-center.json. Run in the project/appPackage directory or select —path. Every applied update carries a higher-version package; never submits.

wiqd update

CommandExtensionDescription
wiqd updatewiqd (core)Update wiqd to the latest version

Configure embedded agents and inspect deployed declarative agents

Extension: wiqd (core)

Terminal window
wiqd agent <command>

Examples

Terminal window
wiqd agent
wiqd agent add
wiqd agent --help

Augment an existing declarative agent with an action, skill, or auth config.

Extension: wiqd Core

Terminal window
wiqd agent add <command>

Examples

Terminal window
wiqd agent add action
wiqd agent add skill
wiqd agent add auth
wiqd agent add --help

Add an OpenAPI or remote MCP action to a declarative agent.

Extension: wiqd Core

Terminal window
wiqd agent add action [options]

Options

OptionDescription
--openapi-spec <value>OpenAPI spec path or URL
--mcp-server-url <value>Remote MCP server HTTPS URL
--mcp-auth-type <value>MCP authentication type (choices: “none”, “oauth”, “oauth-dynamic”, “entra-sso”, “bearer-token”, default: “none”)
--mcp-client-id <value>Static OAuth or Entra SSO client ID
--mcp-client-secret <value>Static OAuth client secret
--mcp-scopes <value>Space-separated static OAuth scopes
--operations <value>OpenAPI operation selectors as METHOD /path (comma-separated; required with —openapi-spec)
--api-key <value>Optional API-key or bearer credential; omitted values are added as environment placeholders
--openapi-auth-identity-provider <value>OpenAPI OAuth identity provider (choices: “oauth”, “microsoft-entra”)
--openapi-auth-client-id <value>Optional OAuth or Microsoft Entra client ID
--openapi-auth-client-secret <value>Optional confidential OAuth client secret
--openapi-auth-scopes <value>Optional space-separated OAuth scopes
--openapi-auth-pkceEnable PKCE for generic OAuth (default: false)
-f, --folder <value>Project folder

Examples

Terminal window
wiqd agent add action --openapi-spec <path-or-url> --operations <selectors>
wiqd agent add action --mcp-server-url <https-url>
wiqd agent add action --mcp-server-url <https-url> --mcp-auth-type oauth --mcp-client-id <id> --mcp-client-secret <secret> [--mcp-scopes <scopes>]
wiqd agent add action --openapi-spec <path-or-url> --operations <selectors> --json

Add an auth configuration to a plugin manifest.

Extension: wiqd Core

Terminal window
wiqd agent add auth [options]

Options

OptionDescription
--plugin-manifest <value>Plugin manifest path
--auth-name <value>Auth configuration name
--operations <value>Plugin function IDs to secure (comma-separated; inferred when only one is available)
--auth-type <value>Authentication type (choices: “bearer-token”, “api-key”, “oauth”, “microsoft-entra”, default: “bearer-token”)
--api-key-in <value>API-key location (used only with —auth-type api-key) (choices: “header”, “query”, default: “header”)
--api-key-name <value>API-key header or query parameter name (required for api-key auth)
--api-key <value>Optional API-key or bearer credential; omitted values are added as environment placeholders
--openapi-spec <value>OpenAPI spec path used to resolve the selected operations
--authorization-url <value>OAuth authorization URL
--token-url <value>OAuth token URL
--scope <value>OAuth scope
--refresh-url <value>Optional OAuth refresh URL
--oauth-pkceEnable PKCE for generic OAuth (default: false)
--oauth-client-id <value>Optional OAuth or Microsoft Entra client ID
--oauth-client-secret <value>Optional confidential OAuth client secret
-f, --folder <value>Project folder

Examples

Terminal window
wiqd agent add auth --plugin-manifest <value> --auth-name <value>
wiqd agent add auth --plugin-manifest <value> --auth-name <value> --operations <value> --auth-type bearer-token
wiqd agent add auth --plugin-manifest <value> --auth-name <value> --json

Add a skill to a declarative agent.

Extension: wiqd Core

Terminal window
wiqd agent add skill [options]

Options

OptionDescription
--name <value>Skill name (required unless —from is used)
--description <value>Skill description
--from <value>Register a skill directory under appPackage, or import an external .zip
-f, --folder <value>Project folder

Examples

Terminal window
wiqd agent add skill
wiqd agent add skill --name <value> --description <value>
wiqd agent add skill --json

Run quality evaluations against a deployed declarative agent.

Extension: Copilot Eval

Terminal window
wiqd agent eval [options] <command>

Options

OptionDescription
--env <value>Target environment (default: “local”)
--path <value>Project path (defaults to CWD)
-c, --config <value>Path to eval prompts file (runevals format) (default: “evals/prompts.json”)
-o, --output <value>Result file path relative to —path. The eval skill uses a timestamped .html path to produce a scorecard; .json remains available for automation. (default: “.evals/results.json”)
--concurrency <value>Optional concurrent scenario override (1-5). When omitted, runevals uses its own default.
--threshold <value>Minimum pass-rate (0-1) to succeed
--agent-id <value>Title ID of a deployed agent to evaluate directly (e.g. T_xxx). When set, the title ID is sourced from this option instead of env/.env..
--account <value>Optional email/UPN forwarded to runevals to select the intended cached MSAL account or prefill interactive sign-in.
--judge-backend <value>LLM-as-judge backend forwarded to runevals. ‘github-copilot’ authenticates via ‘gh auth login’ (or GITHUB_TOKEN), uses model ‘auto’ unless GITHUB_COPILOT_JUDGE_MODEL is set, and never activates Foundry routing. Select ‘azure’—including when explicitly requesting Azure LLMs as judge—to use local Azure OpenAI or, when AZURE_AI_PROJECT_ENDPOINT + AZURE_AI_MODEL_NAME are set, Microsoft Foundry cloud evaluation. Custom .prompty evaluators always require the Azure path. (choices: “github-copilot”, “azure”, default: “github-copilot”)
--eval-log-level <value>runevals log verbosity. Kept distinct from wiqd’s global —log-level option and defaults to ‘debug’ so failures carry enough detail to diagnose without re-running. (choices: “debug”, “info”, “warning”, “error”, default: “debug”)

Examples

Terminal window
wiqd agent eval
wiqd agent eval --env <value> --path <value>
wiqd agent eval --help

Initialize an evaluation prompts.json for a project (drops a fixed seven-item bootstrap for the default declarative-agent template, plus env/.env..user from your Azure OpenAI / tenant env vars). This is not manifest-aware count-based generation.

Extension: Copilot Eval

Terminal window
wiqd agent eval init [options]

Options

OptionDescription
--path <value>Project path (defaults to CWD)
--env <value>Target environment (controls env/.env..user filename) (default: “local”)
--output <value>Output prompts file (runevals auto-discovers evals/prompts.json) (default: “evals/prompts.json”)

Examples

Terminal window
wiqd agent eval init
wiqd agent eval init --path <value> --env <value>
wiqd agent eval init --json

Show MOS3 launch / acquisition info for a deployed agent. Accepts —agent-id (e.g. P_xxx.declarativeAgent), —title-id, or —manifest-id; emits the raw launch-info JSON. Used by the DevUI portal. Requires Microsoft 365 sign-in; use wiqd auth login --interactive.

Extension: wiqd Core

Terminal window
wiqd agent info [options]

Options

OptionDescription
--agent-id <value>Full agent id (e.g. P_xxx.declarativeAgent); the title id is derived from it.
--title-id <value>Title ID of the agent (e.g. P_xxx).
--manifest-id <value>Manifest ID of the agent (GUID).

Examples

Terminal window
wiqd agent info
wiqd agent info --agent-id <value> --title-id <value>
wiqd agent info --json

List declarative agents deployed in the tenant.

Extension: Work IQ

Terminal window
wiqd agent list [options]

Options

OptionDescription
--name <value>Filter by name (substring)
--id <value>Filter by ID (substring)
--top <value>Maximum number of results

Examples

Terminal window
wiqd agent list
wiqd agent list --name <value> --id <value>
wiqd agent list --json

Query the Insights Agent about a provisioned agent’s performance and usage.

Extension: Work IQ

Terminal window
wiqd agent monitor [options]

Options

OptionDescription
-q, --query <value>Natural language query
--env <value>Target environment (default: “local”)
--path <value>Project path (or run standalone)

Examples

Terminal window
wiqd agent monitor
wiqd agent monitor --query <value> --env <value>
wiqd agent monitor --json

Retrieve the real Work IQ A2A agent card by deployed agent ID or name.

Extension: Work IQ

Terminal window
wiqd agent show [options]

Options

OptionDescription
--id <value>Deployed agent ID (takes precedence over —name)
--name <value>Deployed agent name

Examples

Terminal window
wiqd agent show --id <deployed-agent-id>
wiqd agent show --name "<deployed-agent-name>"
wiqd agent show --id <deployed-agent-id> --json

Manage authentication for wiqd and its extensions

Extension: wiqd (core)

Terminal window
wiqd auth <command>

Examples

Terminal window
wiqd auth
wiqd auth login
wiqd auth --help

Sign in to all active auth providers (requires a terminal)

Extension: wiqd (core)

Terminal window
wiqd auth login [options]

Options

OptionDescription
--interactiveAllow provider interactive sign-in (may reuse cached sessions; requires a terminal)
--tenant <tenant-id>Select a tenant for providers that explicitly support tenant-scoped sign-in

Examples

Terminal window
wiqd auth login
wiqd auth login --tenant <tenant-id> --interactive
wiqd auth login --json

Sign out of wiqd services

Extension: wiqd (core)

Terminal window
wiqd auth logout

Examples

Terminal window
wiqd auth logout
wiqd auth logout --json

Show authentication status

Extension: wiqd (core)

Terminal window
wiqd auth status

Examples

Terminal window
wiqd auth status
wiqd auth status --json

token

Extension: wiqd Core

Terminal window
wiqd auth token <command>

Examples

Terminal window
wiqd auth token
wiqd auth token get
wiqd auth token --help

Interactively obtain and deliberately reveal a delegated Microsoft 365 refresh token for caller-managed CI lifecycle authentication. Requires a local terminal; no project or prior login needed.

Extension: wiqd Core

Terminal window
wiqd auth token get [options]

Options

OptionDescription
--tenant <value>Microsoft Entra tenant GUID
--show-tokenRequest one terminal disclosure after human confirmation (never JSON or CI) (default: false)

Examples

Terminal window
wiqd auth token get
wiqd auth token get --tenant <value> --show-token
wiqd auth token get --json

Show wiqd release changelog

Extension: wiqd (core)

Terminal window
wiqd changelog [options]

Options

OptionDescription
--version <version>Show changelog for a specific version (not with —from/—to)
--from <version>Range start, exclusive — releases AFTER this one (not with —version)
--to <version>Range end, inclusive (not with —version); defaults to latest
--markdownEmit canonical markdown (paste-ready; never ANSI-rendered)
--no-markdown-renderDisable inline markdown rendering in text output (always raw markdown)

Examples

Terminal window
wiqd changelog # the latest release
wiqd changelog --version <version> # one specific release
wiqd changelog --from <version> # everything AFTER that release

Output a shell tab-completion script (bash, zsh, powershell, fish)

Extension: wiqd (core)

Terminal window
wiqd completion shell

Arguments

ArgumentDescription
shellTarget shell: bash, zsh, powershell, or fish

Examples

Terminal window
wiqd completion <shell>
wiqd completion <shell> --json

Manage the Work IQ VS Code extension

Extension: wiqd (core)

Terminal window
wiqd component <command>

Examples

Terminal window
wiqd component
wiqd component vscode
wiqd component --help

Manage the Work IQ VS Code extension

Extension: wiqd (core)

Terminal window
wiqd component vscode <command>

Examples

Terminal window
wiqd component vscode
wiqd component vscode info
wiqd component vscode install
wiqd component vscode uninstall
wiqd component vscode --help

Report the VS Code extension install location (stable + insiders)

Extension: wiqd (core)

Terminal window
wiqd component vscode info

Examples

Terminal window
wiqd component vscode info
wiqd component vscode info --json

Install the VS Code extension

Extension: wiqd (core)

Terminal window
wiqd component vscode install [options]

Options

OptionDescription
--insidersTarget VS Code Insiders instead of stable
--forceReinstall even if already present

Examples

Terminal window
wiqd component vscode install
wiqd component vscode install --insiders --force
wiqd component vscode install --json

Uninstall the VS Code extension

Extension: wiqd (core)

Terminal window
wiqd component vscode uninstall [options]

Options

OptionDescription
--insidersTarget VS Code Insiders instead of stable

Examples

Terminal window
wiqd component vscode uninstall
wiqd component vscode uninstall --insiders
wiqd component vscode uninstall --json

Manage wiqd configuration settings

Extension: wiqd (core)

Terminal window
wiqd config <command>

Examples

Terminal window
wiqd config
wiqd config flags
wiqd config reset
wiqd config set
wiqd config --help

Manage wiqd feature flags

Extension: wiqd (core)

Terminal window
wiqd config flags <command>

Examples

Terminal window
wiqd config flags
wiqd config flags list
wiqd config flags --help

List all registered feature flags and their resolved values

Extension: wiqd (core)

Terminal window
wiqd config flags list [options]

Options

OptionDescription
--enabled-onlyShow only boolean flags currently evaluating true (default: false)

Examples

Terminal window
wiqd config flags list
wiqd config flags list --enabled-only
wiqd config flags list --json

Clear a persisted feature flag value

Extension: wiqd (core)

Terminal window
wiqd config flags reset name [options]

Arguments

ArgumentDescription
nameFlag name (mutually exclusive with —all)

Options

OptionDescription
--allClear all persisted feature flag values (default: false)

Examples

Terminal window
wiqd config flags reset
wiqd config flags reset --all
wiqd config flags reset [name]

Persist a feature flag value

Extension: wiqd (core)

Terminal window
wiqd config flags set name value

Arguments

ArgumentDescription
nameFlag name
valueValue to persist (validated against the flag type)

Examples

Terminal window
wiqd config flags set <name> <value>
wiqd config flags set <name> <value> --json

Show definition and resolved value for a single feature flag

Extension: wiqd (core)

Terminal window
wiqd config flags show name

Arguments

ArgumentDescription
nameFlag name (e.g. my-flag)

Examples

Terminal window
wiqd config flags show <name>
wiqd config flags show <name> --json

Reset all configuration to defaults

Extension: wiqd (core)

Terminal window
wiqd config reset

Examples

Terminal window
wiqd config reset
wiqd config reset --json

Set configuration values

Extension: wiqd (core)

Terminal window
wiqd config set pairs

Arguments

ArgumentDescription
pairsKey=value pairs to set

Examples

Terminal window
wiqd config set
wiqd config set [pairs...]

Discover catalog connectors and create MCP or REST API connectors

Extension: wiqd (core)

Terminal window
wiqd connector <command>

Examples

Terminal window
wiqd connector
wiqd connector add
wiqd connector list
wiqd connector show
wiqd connector --help

Create a connector for a remote MCP server or Swagger 2.0 REST API through production MCP Platform.

Extension: wiqd Core

Terminal window
wiqd connector add [options]

Options

OptionDescription
--input-file <value>Private JSON with displayName, authentication and either serverUrl (MCP) or apiDefinition (Swagger 2.0)
--dry-runValidate input offline without authentication or creation

Examples

Terminal window
wiqd connector add --input-file <value>
wiqd connector add --input-file <value> --dry-run
wiqd connector add --input-file <value> --json

Discover remote MCP and preview OpenAPI connectors from the Microsoft 365 catalog.

Extension: wiqd Core

Terminal window
wiqd connector list [options]

Options

OptionDescription
--search <value>Filter title, connector, description, ID, or reference ID
--auth-type <value>Filter by exact connector authorization type
--top <value>Maximum number of connectors to return

Examples

Terminal window
wiqd connector list
wiqd connector list --search <value> --auth-type <value>
wiqd connector list --json

Show a canonical catalog agentConnector node.

Extension: wiqd Core

Terminal window
wiqd connector show selector

Arguments

ArgumentDescription
selectorSelector emitted by ‘connector list’

Examples

Terminal window
wiqd connector show
wiqd connector show [selector]

Launch the local Work IQ DevUI web experience

Extension: wiqd (core)

Terminal window
wiqd devui <command>

Examples

Terminal window
wiqd devui
wiqd devui ask
wiqd devui --help

Ask an agent and watch the turn run live in the local Work IQ DevUI (deep-linked + auto-sent).

Extension: Work IQ DevUI

Terminal window
wiqd devui ask [options]

Options

OptionDescription
-q, --query <value>Prompt to send to the agent
--agent <value>Agent id or name to target (deep-link)
--transport <value>Connection transport: direct (A2A cloud) | cli (choices: “direct”, “cli”, default: “direct”)
--port <value>Loopback port to serve DevUI on (default: 7317)
--no-openDo not open a browser; print the URL instead

Examples

Terminal window
wiqd devui ask --query <value>
wiqd devui ask --query <value> --agent <value> --transport direct
wiqd devui ask --query <value> --json

Configure DevUI to mint access tokens with your own Entra app registration (skip the workiq CLI). Running start afterwards forces an initial sign-in.

Extension: Work IQ DevUI

Terminal window
wiqd devui config [options]

Options

OptionDescription
--client-id <value>Your Entra public-client app id used to mint the WorkIQ access token
--tenant <value>Tenant id or domain to sign in against (default: organizations)
--clearClear the client id and fall back to the workiq CLI

Examples

Terminal window
wiqd devui config
wiqd devui config --client-id <value> --tenant <value>
wiqd devui config --json

Start (or reuse) the local Work IQ DevUI and open it in the browser.

Extension: Work IQ DevUI

Terminal window
wiqd devui start [options]

Options

OptionDescription
--agent <value>Agent id or name to preselect (deep-link)
--transport <value>Connection transport: direct (A2A cloud) | cli (choices: “direct”, “cli”, default: “direct”)
--port <value>Loopback port to serve DevUI on (default: 7317)
-q, --query <value>Prompt to prefill in the GUI
--no-sendWith —query, prefill the composer without auto-sending
--no-openDo not open a browser; print the URL instead
--no-windowNever open a separate console window (Windows); run the server headless

Examples

Terminal window
wiqd devui start
wiqd devui start --agent <value> --transport direct
wiqd devui start --json

Stop the running local Work IQ DevUI (release its server and the install-directory lock).

Extension: Work IQ DevUI

Terminal window
wiqd devui stop [options]

Options

OptionDescription
--port <value>Loopback port the DevUI is served on (default: 7317)

Examples

Terminal window
wiqd devui stop
wiqd devui stop --port <value>
wiqd devui stop --json

Collect local diagnostics without changing the installation

Extension: wiqd (core)

Terminal window
wiqd diagnostics <command>

Examples

Terminal window
wiqd diagnostics
wiqd diagnostics collect
wiqd diagnostics --help

Write a private, read-only diagnostic evidence archive

Extension: wiqd (core)

Terminal window
wiqd diagnostics collect [options]

Options

OptionDescription
--output <archive.json.gz>New local gzip JSON archive (existing parent required)
--log <file>Existing structured JSON-lines log (repeat up to four times) (default: [])

Examples

Terminal window
wiqd diagnostics collect --output <archive.json.gz>
wiqd diagnostics collect --output <archive.json.gz> --log <file>
wiqd diagnostics collect --output <archive.json.gz> --json

Check environment health (Node.js, extensions, auth)

Extension: wiqd (core)

Terminal window
wiqd doctor

Examples

Terminal window
wiqd doctor
wiqd doctor --json

Accept or report WIQD and downstream-tool End User License Agreements (EULAs)

Extension: wiqd (core)

Terminal window
wiqd eula <command>

Examples

Terminal window
wiqd eula
wiqd eula accept
wiqd eula status
wiqd eula --help

Accept one tool’s EULA through the human-confirmed acceptance path

Extension: wiqd (core)

Terminal window
wiqd eula accept tool [options]

Arguments

ArgumentDescription
toolThe EULA-gated tool to accept (run wiqd eula status to list them)

Options

OptionDescription
--yesAccept the current WIQD EULA without prompting, including in CI. WIQD only; never downstream or mock.
--consent <phrase>A non-TTY phrase matching the complete affirmative template for the named EULA, exact URL, and current version when surfaced. No default or additional language; TTY use, CI, and —mock are refused.

Examples

Terminal window
wiqd eula accept <tool>
wiqd eula accept <tool> --consent <phrase> --yes
wiqd eula accept <tool> --json

Report EULA-acceptance state for all EULA-gated tools

Extension: wiqd (core)

Terminal window
wiqd eula status

Examples

Terminal window
wiqd eula status
wiqd eula status --json

Run an extension-managed CLI (e.g. workiq) with args forwarded verbatim (use -- <flags> to forward flags that collide with wiqd globals)

Extension: wiqd (core)

Terminal window
wiqd exec cli args

Arguments

ArgumentDescription
cliName of the managed CLI to run (e.g. workiq)
argsArguments forwarded to the CLI unchanged

Examples

Terminal window
wiqd exec <cli> --help
wiqd exec <cli> <subcommand> [args...]
wiqd exec <cli> <subcommand> -- --json # forward a flag that collides with a wiqd global

Manage installed wiqd extensions

Extension: wiqd (core)

Terminal window
wiqd ext <command>

Examples

Terminal window
wiqd ext
wiqd ext add
wiqd ext --help

Activate an installed extension (registers it in ~/.wiqd/extensions.json)

Extension: wiqd (core)

Terminal window
wiqd ext add id

Arguments

ArgumentDescription
idExtension manifest ID or npm package name

Examples

Terminal window
wiqd ext add <id>
wiqd ext add <id> --json

List discovered and registered extensions

Extension: wiqd (core)

Terminal window
wiqd ext list

Examples

Terminal window
wiqd ext list
wiqd ext list --json

Deactivate an extension (removes it from ~/.wiqd/extensions.json)

Extension: wiqd (core)

Terminal window
wiqd ext remove id

Arguments

ArgumentDescription
idExtension manifest ID or npm package name

Examples

Terminal window
wiqd ext remove <id>
wiqd ext remove <id> --json

Show extension details

Extension: wiqd (core)

Terminal window
wiqd ext show id

Arguments

ArgumentDescription
idExtension ID

Examples

Terminal window
wiqd ext show <id>
wiqd ext show <id> --json

List and submit feedback about wiqd

Extension: wiqd (core)

Terminal window
wiqd feedback <command>

Examples

Terminal window
wiqd feedback
wiqd feedback list
wiqd feedback submit
wiqd feedback --help

List feedback you submitted through wiqd.

Extension: GitHub

Terminal window
wiqd feedback list [options]

Options

OptionDescription
-n, --top <value>Number of items to show
--status <value>Filter by status (open, closed, all)

Examples

Terminal window
wiqd feedback list
wiqd feedback list --top <value> --status <value>
wiqd feedback list --json

Submit feedback about wiqd as a GitHub issue.

Extension: GitHub

Terminal window
wiqd feedback submit [options]

Options

OptionDescription
--type <value>Feedback type (bug, feature, improvement, question, docs, performance). Security issues: see SECURITY.md instead.
--title <value>Feedback title
--description <value>Feedback description
--sentiment <value>Feedback sentiment (positive, negative)
--no-contextOmit auto-collected environment context
--dry-runShow what would be submitted

Examples

Terminal window
wiqd feedback submit
wiqd feedback submit --type <value> --title <value>
wiqd feedback submit --json

Install the public WIQD plugin through a supported host’s native marketplace.

Extension: wiqd (core)

Terminal window
wiqd marketplace <command>

Examples

Terminal window
wiqd marketplace
wiqd marketplace setup
wiqd marketplace --help

Install the public wiqd@wiqd plugin from microsoft/wiqd, or keep a verified existing public Copilot installation. This does not configure your complete WIQD environment.

Extension: wiqd Core

Terminal window
wiqd marketplace setup [options]

Options

OptionDescription
--host <value>Select one supported host: copilot or claude (default: detect both)
--marketplace <value>Public acquisition source (default and only accepted value: microsoft/wiqd)
--dry-runInspect native state and report planned actions without changing it (default: false)

Examples

Terminal window
wiqd marketplace setup
wiqd marketplace setup --host <value> --marketplace <value>
wiqd marketplace setup --json

Build, validate, package, and publish standalone plugins (agent + skills + connector)

Extension: wiqd (core)

Terminal window
wiqd plugin <command>

Examples

Terminal window
wiqd plugin
wiqd plugin add
wiqd plugin --help

add

Extension: wiqd Core

Terminal window
wiqd plugin add <command>

Examples

Terminal window
wiqd plugin add
wiqd plugin add agent
wiqd plugin add --help

Compose one declarative agent into an existing plugin without replacing plugin-owned files.

Extension: wiqd Core

Terminal window
wiqd plugin add agent [options]

Options

OptionDescription
-t, --template <value>Agent template from ‘wiqd plugin list templates’ (choices: “declarative-agent”, default: “declarative-agent”)
-n, --name <value>Embedded agent name (defaults to the plugin name)
-f, --folder <value>Plugin project folder (defaults to CWD)

Examples

Terminal window
wiqd plugin add agent
wiqd plugin add agent --template declarative-agent --name <value>
wiqd plugin add agent --json

Add and read-back verify one M365 plugin title co-owner.

Extension: wiqd Core

Terminal window
wiqd plugin add collaborator [options]

Options

OptionDescription
--email <value>One directory email or UPN
--env <value>Target environment (default: “local”)
--path <value>Plugin project path (defaults to CWD)

Examples

Terminal window
wiqd plugin add collaborator --email <value>
wiqd plugin add collaborator --email <value> --env <value> --path <value>
wiqd plugin add collaborator --email <value> --json

Add a catalog connector (—selector), a remote MCP connector, or an OpenAPI custom connector to the plugin manifest.

Extension: wiqd Core

Terminal window
wiqd plugin add connector [options]

Options

OptionDescription
--selector <value>Catalog connector selector emitted by ‘wiqd connector list’ (replaces the manual connector options)
-n, --name <value>Connector display name (required unless —selector)
--description <value>Connector description (required unless —selector)
--kind <value>Connector kind (choices: “remote-mcp”, “openapi”, default: “remote-mcp”)
--url <value>Remote MCP server https:// URL (required for remote-mcp)
--tool-description <value>Existing tool-description file, relative to appPackage/
--auth-type <value>Remote MCP authorization type (omission with a reference uses devPreview-only ConnectionVault; otherwise none) (choices: “none”, “oauth”, “api-key”, “dcr”)
--auth-reference-id <value>Existing connector reference (devPreview-only ConnectionVault when auth-type is omitted), explicit MCP credential reference, or OpenAPI logical name
--dev-previewExplicitly move the manifest to devPreview for OpenAPI or inferred remote MCP ConnectionVault
-f, --folder <value>Plugin project folder (defaults to CWD)

Examples

Terminal window
wiqd plugin add connector --name "Contoso Tools" --description "MCP toolbelt" --url https://tools.contoso.com/mcp
wiqd plugin add connector --kind openapi --name "Contoso Kusto" --description "Existing custom connector" --auth-reference-id shared_kusto --dev-preview
wiqd plugin add connector --kind openapi --name "Contoso Kusto" --description "Existing custom connector" --auth-reference-id shared_kusto --dev-preview --json

Copy an existing plugin environment to a new name.

Extension: wiqd Core

Terminal window
wiqd plugin add environment [options]

Options

OptionDescription
--name <value>New environment name
--from <value>Source environment (default: “local”)
-f, --folder <value>Plugin project folder (defaults to CWD)

Examples

Terminal window
wiqd plugin add environment --name <value>
wiqd plugin add environment --name <value> --from <value> --folder <value>
wiqd plugin add environment --name <value> --json

Save .validate/listing.json with approved publishing-only details. Replaces the whole listing; use ‘wiqd plugin preview market-listing’ afterward for HTML confirmation. Does not validate or publish.

Extension: Validation & LSP

Terminal window
wiqd plugin add market-listing [options]

Options

OptionDescription
--agent-folder <value>Agent project or ZIP-only folder; output is .validate/listing.json
--package-file <value>Exact final ZIP; otherwise require one ZIP in appPackage/build or the ZIP-only folder
--language <value>Package default locale only (default package locale or en-US)
--app-name <value>Approved Marketplace title (default manifest name.short)
--developer-name <value>Approved developer name (default manifest developer.name)
--offer-type <value>Offer type (default microsoft-365); shown in the complete HTML review without a separate collection question (choices: “microsoft-365”, “other”)
--short-description <value>Approved short description as plain text (default package value)
--full-description <value>Approved full description as plain text (default package value)
--privacy-policy-url <value>Approved privacy policy URL (default package value)
--terms-of-use-url <value>Approved terms URL (default package value)
--support-document-link <value>Approved public HTTPS support documentation URL
--screenshots <value>Comma-separated local PNG paths, 1–20; omission records incomplete coverage
--video-url <value>Optional approved YouTube/Vimeo HTTPS product-video URL. Recommend 60-90 seconds for value/demo guidance, not a duration cap. Native validation owns the host check.
--categories <value>1-3 comma-separated Partner Center categories: Accounting + finance, Collaboration, Content management, CRM, Data + analytics, File managers, IT/admin, Legal + HR, Maps, News + weather, Productivity, Project management, Reference, Sales + marketing, Site Design, Social, Training & Tutorial, Utilities + tools, Workflow & Process Management
--industries <value>Up to 2 comma-separated industries, or none: Agriculture, Distribution, Education, Finance, Government, Healthcare, Manufacturing, Professional Services, Retail, Sustainability
--requires-associated-service-purchase <value>Confirmed associated service or additional in-app purchases requirement; publishing only (choices: “true”, “false”)
--use-standard-contract <value>true selects Microsoft’s Standard Contract EULA at https://go.microsoft.com/fwlink/?linkid=2041178; conflicts with a different explicit terms URL (choices: “true”, “false”)
--search-terms <value>Up to 3 distinct comma-separated complementary Marketplace search keywords; omitted means none
--test-instructions <value>Private certification instructions as plain text, without credentials; required unless a PDF is supplied; publishing only
--test-instructions-file <value>Local certification PDF, at most 5 MiB; copied and linked in the preview, never evaluated by validation
--offer-id <value>Internal Partner Center lookup ID; lowercase letters, digits, dashes or underscores, max 50, not ending -preview; default generated from app name and app ID
--offer-alias <value>Internal Partner Center lookup alias, not public display copy; default approved app name
--availability-date <value>Publishing-only UTC date YYYY-MM-DD; omit to store null (publish when ready), without scheduling publication
--publish-markets <value>worldwide (default), or distinct comma-separated two-letter country/region codes to include, e.g. US,CA; confirmed through natural-language collection
--exclude-markets <value>Distinct comma-separated two-letter country/region codes excluded from worldwide; cannot combine with —publish-markets

Examples

Terminal window
wiqd plugin add market-listing --agent-folder <value> --categories <value> --industries <value> --requires-associated-service-purchase true
wiqd plugin add market-listing --agent-folder <value> --categories <value> --industries <value> --requires-associated-service-purchase true --package-file <value> --language <value>
wiqd plugin add market-listing --agent-folder <value> --categories <value> --industries <value> --requires-associated-service-purchase true --json

Scaffold a SKILL.md skill folder and register it in the plugin manifest.

Extension: wiqd Core

Terminal window
wiqd plugin add skill [options]

Options

OptionDescription
-n, --name <value>Skill display name
-f, --folder <value>Plugin project folder (defaults to CWD)

Examples

Terminal window
wiqd plugin add skill --name <value>
wiqd plugin add skill --name <value> --folder <value>
wiqd plugin add skill --name <value> --json

Send a message directly to a declarative agent component.

Extension: Work IQ

Terminal window
wiqd plugin ask [options]

Options

OptionDescription
--component <value>Plugin component to invoke (currently: agent) (choices: “agent”)
-q, --query <value>Message to send to the agent
--agent-id <value>Agent ID
--agent-name <value>Agent name
--env <value>Target environment (default: “local”)
--path <value>Project path
--devuiProxy the ask through the local Work IQ DevUI (A2A) so the call is captured and inspectable there; falls back to a direct ask if DevUI isn’t running.
--developerInclude Work IQ developer execution metadata; may contain sensitive diagnostics

Examples

Terminal window
wiqd plugin ask --component agent --query <value>
wiqd plugin ask --component agent --query <value> --agent-id <value> --agent-name <value>
wiqd plugin ask --component agent --query <value> --json

Scaffold a new, empty standalone plugin project from the built-in blank app template.

Extension: wiqd Core

Terminal window
wiqd plugin create [options]

Options

OptionDescription
-n, --name <value>Plugin project name
-o, --output <value>Output directory (defaults to CWD)
--forceRe-scaffold over a non-empty destination, discarding what is there now

Examples

Terminal window
wiqd plugin create --name <value>
wiqd plugin create --name <value> --output <value> --force
wiqd plugin create --name <value> --json

Delete a plugin’s provisioned cloud resources. Either by env (project-based) or by —title-id (works for any plugin you can administer, no local project required). Requires Microsoft 365 sign-in; use wiqd auth login --interactive.

Extension: wiqd Core

Aliases: uninstall

Terminal window
wiqd plugin delete [options]

Options

OptionDescription
-e, --env <value>Environment to delete (ignored when —title-id is set) (default: “local”)
--path <value>Plugin project path (ignored when —title-id is set)
--title-id <value>Title ID of the plugin to delete (e.g. T_xxx or T_xxx.declarativeAgent). When set, deletes via title-id mode and skips project/env checks.
--keep-env-fileKeep the local env file after deletion (project mode only)
--yesSkip confirmation prompt

Examples

Terminal window
wiqd plugin delete
wiqd plugin delete --env <value> --path <value>
wiqd plugin delete --json

Export a plugin project to Open Plugin (or Claude/Cursor) format.

Extension: wiqd Core

Terminal window
wiqd plugin export [options]

Options

OptionDescription
-p, --path <value>Plugin project path (defaults to CWD)
-o, --output <value>Output Open Plugin directory (defaults to /export/)
--format <value>Export format (choices: “open-plugin”, “claude-plugin”, “cursor-plugin”, default: “open-plugin”)

Examples

Terminal window
wiqd plugin export
wiqd plugin export --path <value> --output <value>
wiqd plugin export --json

Get plugin resources.

Extension: Validation & LSP

Terminal window
wiqd plugin get <command>

Examples

Terminal window
wiqd plugin get
wiqd plugin get market-listing
wiqd plugin get --help

Read .validate/listing.json and check any supported schema, including 1.0. Missing files return 404; invalid listings fail explicitly. No policy or media checks.

Extension: Validation & LSP

Terminal window
wiqd plugin get market-listing [options]

Options

OptionDescription
--agent-folder <value>Agent project or ZIP-only folder containing .validate/listing.json
--listing-file <value>Explicit listing JSON to read instead of .validate/listing.json

Examples

Terminal window
wiqd plugin get market-listing --agent-folder <value>
wiqd plugin get market-listing --agent-folder <value> --listing-file <value>
wiqd plugin get market-listing --agent-folder <value> --json

Import an Open Plugin (or Claude/Cursor plugin) as a new plugin project.

Extension: wiqd Core

Terminal window
wiqd plugin import [options]

Options

OptionDescription
-p, --path <value>Source Open Plugin directory
-o, --output <value>Destination project directory (defaults to ./)
--privacy-url <value>Privacy statement URL (required unless the source carries the round-trip block)
--terms-url <value>Terms-of-use URL (required unless the source carries the round-trip block)
--website-url <value>Website URL (falls back to plugin.json homepage/author URL)
--app-id <value>Teams/M365 app id (UUID) to stamp
--default-auth-type <value>Default plugin auth type (default: Auto) (choices: “Auto”, “None”, “OAuthPluginVault”, “ApiKeyPluginVault”)
--package-name <value>Reverse-DNS package name

Examples

Terminal window
wiqd plugin import --path <value>
wiqd plugin import --path <value> --output <value> --privacy-url <value>
wiqd plugin import --path <value> --json

List standalone plugin projects under a directory.

Extension: wiqd Core

Terminal window
wiqd plugin list [options] <command>

Options

OptionDescription
-n, --name <value>Filter by plugin name substring
--top <value>Limit the number of results
--root <value>Root directory to scan (defaults to CWD)

Examples

Terminal window
wiqd plugin list
wiqd plugin list --name <value> --top <value>
wiqd plugin list --help

List verified co-owners for the selected M365 plugin title, including standalone plugins.

Extension: wiqd Core

Terminal window
wiqd plugin list collaborators [options]

Options

OptionDescription
--env <value>Target environment (default: “local”)
--path <value>Plugin project path (defaults to CWD)

Examples

Terminal window
wiqd plugin list collaborators
wiqd plugin list collaborators --env <value> --path <value>
wiqd plugin list collaborators --json

List environments from the lifecycle-configured environment folder.

Extension: wiqd Core

Terminal window
wiqd plugin list environments [options]

Options

OptionDescription
-f, --folder <value>Plugin project folder (defaults to CWD)

Examples

Terminal window
wiqd plugin list environments
wiqd plugin list environments --folder <value>
wiqd plugin list environments --json

List supported templates for ‘wiqd plugin add agent’.

Extension: wiqd Core

Terminal window
wiqd plugin list templates

Examples

Terminal window
wiqd plugin list templates
wiqd plugin list templates --json

Package the plugin into a .zip. Use —offline for a local-only preview connector/skill package without provisioning or server validation.

Extension: wiqd Core

Terminal window
wiqd plugin package [options]

Options

OptionDescription
--offlineBuild a local-only devPreview connector/skill ZIP; automatically persist a local package ID without provisioning (default: false)
--env <value>Environment to resolve variables from; output label only with —offline (default: “local”)
--output <value>Output path for the zip package
--include-file <value>Include one regular project file unchanged at the ZIP root
--path <value>Plugin project path (defaults to CWD)

Examples

Terminal window
wiqd plugin package
wiqd plugin package --env <value> --output <value>
wiqd plugin package --json

Preview plugin resources.

Extension: Validation & LSP

Terminal window
wiqd plugin preview <command>

Examples

Terminal window
wiqd plugin preview
wiqd plugin preview market-listing
wiqd plugin preview --help

Generate a read-only HTML review of an existing valid listing and its local media. Supports legacy listings without recollection; no package, AI or validation execution.

Extension: Validation & LSP

Terminal window
wiqd plugin preview market-listing [options]

Options

OptionDescription
--agent-folder <value>Workspace for .validate/reviews; defaults to reading its .validate/listing.json
--listing-file <value>Explicit existing listing JSON to review without modifying it or its assets

Examples

Terminal window
wiqd plugin preview market-listing --agent-folder <value>
wiqd plugin preview market-listing --agent-folder <value> --listing-file <value>
wiqd plugin preview market-listing --agent-folder <value> --json

Provision a plugin to an environment after validating bundled DA skill and Worker references. Requires Microsoft 365 sign-in; use wiqd auth login --interactive.

Extension: wiqd Core

Terminal window
wiqd plugin provision [options] <command>

Options

OptionDescription
-e, --env <value>Target environment (default: “local”)
--path <value>Plugin project path (defaults to CWD)

Examples

Terminal window
wiqd plugin provision
wiqd plugin provision --env <value> --path <value>
wiqd plugin provision --help

Prepare or personally sideload a final DA or supported MCP connector ZIP without a source project.

Extension: wiqd Core

Terminal window
wiqd plugin provision package [options]

Options

OptionDescription
--package-file <value>Final DA or supported single-MCP connector ZIP
--output <value>Private preparation directory
--connector-auth-type <value>Explicit anonymous selection only for omitted connector authorization (choices: “None”)
--dry-runPrepare locally without authentication or installation
--reconcileRead retained sideload status without another upload
--preparation-sha256 <value>Require the exact preparation-record hash
--expected-tenant <value>Require the currently signed-in tenant
--expected-account <value>Require the currently signed-in account

Examples

Terminal window
wiqd plugin provision package --package-file <value> --output <value>
wiqd plugin provision package --package-file <value> --output <value> --connector-auth-type None --preparation-sha256 <value>
wiqd plugin provision package --package-file <value> --output <value> --json

Submit a provisioned plugin to the tenant organization app catalog for administrator approval. Requires Microsoft 365 sign-in; use wiqd auth login --interactive.

Extension: wiqd Core

Terminal window
wiqd plugin publish [options]

Options

OptionDescription
--env <value>Environment to publish (default: “local”)
--path <value>Plugin project path (defaults to CWD)
--manifest <value>Contained app manifest file override
--dry-runRun the validation pipeline and report readiness without submitting (default: false)
--no-runtimeSkip Phase 3 (agent response sampling) and Phase 4 (browser) in dry-run mode
--no-networkSkip Phase 2 (URL reachability) in dry-run mode
--browserOpt in to Phase 4 headless-browser checks (requires Playwright; bundled tabs only) (default: false)
--prompts <value>Path to a YAML file overriding the 5 canonical Phase 3 prompts
--artifacts <value>Restrict report artifacts (choices: “md”, “html”, “json”, “all”, default: “all”)

Examples

Terminal window
wiqd plugin publish
wiqd plugin publish --env <value> --path <value>
wiqd plugin publish --json

Remove plugin access.

Extension: wiqd Core

Terminal window
wiqd plugin remove <command>

Examples

Terminal window
wiqd plugin remove
wiqd plugin remove access
wiqd plugin remove --help

Remove plugin usage or existing shared-access grants. This is not title co-owner removal.

Extension: wiqd Core

Terminal window
wiqd plugin remove access [options]

Options

OptionDescription
--users <value>Comma-separated usage recipients to revoke
--owners <value>Comma-separated existing shared-access owners to revoke
--env <value>Target environment (default: “local”)
--path <value>Plugin project path (defaults to CWD)

Examples

Terminal window
wiqd plugin remove access
wiqd plugin remove access --users <value> --owners <value>
wiqd plugin remove access --json

Repair plugin artifacts.

Extension: Validation & LSP

Terminal window
wiqd plugin repair <command>

Examples

Terminal window
wiqd plugin repair
wiqd plugin repair package
wiqd plugin repair --help

Apply explicit hash-bound replacements to a new ZIP without a source project. Preserves the original; does not validate or publish.

Extension: Validation & LSP

Terminal window
wiqd plugin repair package [options]

Options

OptionDescription
--package-file <value>Original final ZIP
--changes-file <value>JSON with packageSha256 and replacements [{path,contentPath}]
--output <value>Previously absent output ZIP path

Examples

Terminal window
wiqd plugin repair package --package-file <value> --changes-file <value> --output <value>
wiqd plugin repair package --package-file <value> --changes-file <value> --output <value> --json

Reset plugin state.

Extension: wiqd Core

Terminal window
wiqd plugin reset <command>

Examples

Terminal window
wiqd plugin reset
wiqd plugin reset environment
wiqd plugin reset --help

Reset a plugin environment and its optional .user sidecar.

Extension: wiqd Core

Terminal window
wiqd plugin reset environment [options]

Options

OptionDescription
--env <value>Environment to reset
-f, --folder <value>Plugin project folder (defaults to CWD)

Examples

Terminal window
wiqd plugin reset environment --env <value>
wiqd plugin reset environment --env <value> --folder <value>
wiqd plugin reset environment --env <value> --json

Share a plugin with users or the entire tenant. Requires Microsoft 365 sign-in; use wiqd auth login --interactive.

Extension: wiqd Core

Terminal window
wiqd plugin share [options]

Options

OptionDescription
--scope <value>Share scope: ‘users’ or ‘tenant’ (choices: “users”, “tenant”, default: “users”)
--email <value>Comma-separated email addresses
--env <value>Target environment (default: “local”)
--path <value>Plugin project path (defaults to CWD)

Examples

Terminal window
wiqd plugin share
wiqd plugin share --scope users --email <value>
wiqd plugin share --json

Show complete offline details for a local plugin and its optional embedded agent.

Extension: wiqd Core

Terminal window
wiqd plugin show [options]

Options

OptionDescription
--path <value>Plugin project path (defaults to CWD)
-n, --name <value>Plugin name to locate under CWD (exact match)
--env <value>Filter environments shown

Examples

Terminal window
wiqd plugin show
wiqd plugin show --path <value> --name <value>
wiqd plugin show --json

Validate plugin source offline, a final package with TDP (default), or package and Marketplace readiness. Package/Marketplace upload the ZIP and may require Core sign-in.

Extension: Validation & LSP

Terminal window
wiqd plugin validate [options]

Options

OptionDescription
--mode <value>source (offline project), package (default; uploads ZIP), or marketplace (package and policy checks) (default: “package”)
--path <value>Project root for package discovery (defaults to CWD)
--env <value>Project environment context; does not select a marketplace package (default: “local”)
--package-file <value>Exact ZIP to audit, relative to CWD; otherwise require one appPackage/build/*.zip
--listing-file <value>Package-bound AppSource listing evidence JSON
--ai-mode <value>StoreOps AI evidence mode (default auto; off still permits deterministic network checks) (choices: “auto”, “copilot”, “off”)
--ai-timeout <value>Planner and independent audit acquisition/AI budgets in seconds, 1–1200 each (default 240); collection is separately bounded
--ai-evidence-file <value>Request-bound AI evidence JSON; requires —ai-mode off
--agent-id <value>Exact deployed target for automatic read-only functional collection; up to 12 scenarios, default 180 seconds total (marketplace only)
--functional-timeout <value>Overall functional collection budget in seconds, 1–900 (default 180); requires —agent-id and marketplace
--functional-request-timeout <value>Per-request collection timeout in seconds, 1–900 (default 60); requires —agent-id and marketplace, bounded by the overall budget
--connector-plan-file <value>Use a reviewed, package-bound read-only operation and concrete public or synthetic-fixture inputs; requires —agent-id and marketplace
--connector-scenario <value>Approve one bounded public-example read-only connector test using existing access; requires —agent-id and marketplace, never signs in or modifies data (choices: “public-example”)
--functional-batchCollect independent conversational questions in one shared structured request; requires —agent-id and marketplace, with no retry or fallback
--functional-batch-allow-duplicate-jsonAllow two identical complete batch JSON documents, preserving raw evidence and marking normalization; requires —functional-batch (default off)
--functional-evidence-file <value>Replay package-bound observations without target calls; mutually exclusive with —agent-id
--repair-context <value>Explicit previous report/hash, original modes and authorized changes JSON for cumulative repair history (Marketplace required)
--autofix-telemetryTelemetry-only marker for authorized Auto Fix revalidation; does not apply repairs

Examples

Terminal window
wiqd plugin validate
wiqd plugin validate --mode <value> --path <value>
wiqd plugin validate --json

Work IQ maker-policy operations

Extension: wiqd (core)

Terminal window
wiqd policy <command>

Examples

Terminal window
wiqd policy
wiqd policy publish
wiqd policy --help

Publish Work IQ policy for an existing title through the native SDK. Requires a compatible SDK and prior Microsoft 365 sign-in.

Extension: wiqd Core

Terminal window
wiqd policy publish [options]

Options

OptionDescription
--title-id <value>Explicit existing MOS title ID
--file <value>Policy JSON file validated and captured by the native SDK
--caller-id <value>Explicit runtime App ID used for Work IQ policy binding

Examples

Terminal window
wiqd policy publish --title-id <value> --file <value> --caller-id <value>
wiqd policy publish --title-id <value> --file <value> --caller-id <value> --json

Publish prepared packages to a registry or marketplace

Extension: wiqd (core)

Terminal window
wiqd publish <command>

Examples

Terminal window
wiqd publish
wiqd publish pc
wiqd publish --help

Run the real preflight, Draft preparation, and submission flow in order. Requires —interactive with separate typed submission authorization, or —authorize-submit for unattended submission; Draft confirmation is supplied internally to the composed preparation stage.

Extension: Partner Center Publishing Foundation

Terminal window
wiqd publish pc [options] <command>

Options

OptionDescription
--path <value>Project context (default .).
--listing <value>Listing file used for binding, publishing inputs, and the prepared Product (default partner-center.json).
--package <value>Candidate ZIP path; bypasses fresh package generation and is validated, frozen, and uploaded during Draft preparation.
--package-env <value>Agent lifecycle environment used to build a fresh ZIP when —package is omitted. (default: “local”)
--release-notes <value>Explicit release-note override.
--availability-date <value>ISO timestamp with seconds and timezone.
--listing-onlyAssert a listing-only change; still cross-checked by the real preflight.
--interactiveRequests typed submission authorization at a real terminal after Draft verification. Choose this or —authorize-submit, not both.
--authorize-submitExplicitly authorizes submission of the verified Draft for this invocation without a prompt. Choose this or —interactive, not both. Does not grant authentication or bypass certification.

Examples

Terminal window
wiqd publish pc
wiqd publish pc --path <value> --listing <value>
wiqd publish pc --help

Show static Marketplace publisher setup guidance; WIQD cannot verify publishing readiness at this time.

Extension: Partner Center Publishing Foundation

Terminal window
wiqd publish pc access

Examples

Terminal window
wiqd publish pc access
wiqd publish pc access --json

Scaffold or read partner-center.json for this project; optionally verifies —product-id against the real Product.

Extension: Partner Center Publishing Foundation

Terminal window
wiqd publish pc init [options]

Options

OptionDescription
--path <value>Project context (default .).
--listing <value>Destination partner-center.json path (default partner-center.json); scaffolded if absent.
--product-id <value>Canonical product/ binding; verified with a real REST read.

Examples

Terminal window
wiqd publish pc init
wiqd publish pc init --path <value> --listing <value>
wiqd publish pc init --json

Read the real Product/resource-tree and classify the proposed change (listing-only vs. package/version impact).

Extension: Partner Center Publishing Foundation

Terminal window
wiqd publish pc preflight [options]

Options

OptionDescription
--path <value>Project context (default .).
--listing <value>Listing file read for the bound Product (default partner-center.json).
--package <value>Candidate ZIP path; bypasses fresh package generation and is hashed for the change classification.
--package-env <value>Agent lifecycle environment used to build the temporary preflight ZIP when —package is omitted. (default: “local”)
--release-notes <value>Explicit release-note override.
--availability-date <value>ISO timestamp with seconds and timezone.
--listing-onlyAssert a listing-only change; still cross-checked against the real classification.

Examples

Terminal window
wiqd publish pc preflight
wiqd publish pc preflight --path <value> --listing <value>
wiqd publish pc preflight --json

Create/update the real Draft: configure listing fields, upload package/assets via MCP, and record the Product ID locally.

Extension: Partner Center Publishing Foundation

Terminal window
wiqd publish pc prepare [options]

Options

OptionDescription
--path <value>Project context (default .).
--listing <value>Listing context (default partner-center.json); read for binding and written with the Draft Product ID.
--package <value>Candidate ZIP path; bypasses fresh package generation and is uploaded via MCP when package changes are required.
--package-env <value>Agent lifecycle environment used to build and retain a fresh ZIP when —package is omitted. (default: “local”)
--release-notes <value>Explicit release-note override.
--availability-date <value>ISO timestamp with seconds and timezone.
--listing-onlyAssert a listing-only change; still cross-checked against the real classification.
--interactiveGuided shape only; no prompts.
--yesRequired for Draft updates. Does not authorize submission.

Examples

Terminal window
wiqd publish pc prepare
wiqd publish pc prepare --path <value> --listing <value>
wiqd publish pc prepare --json

Show a synthetic resume result; no operation is read, reconciled, or continued.

Extension: Partner Center Publishing Foundation

Terminal window
wiqd publish pc resume [options]

Options

OptionDescription
--path <value>Project context (default .); no files are read.
--listing <value>Binding context (default partner-center.json); no file is read.
--operation <value>Operation selector; no receipt is read.
--interactiveGuided shape only; no prompts or consent.

Examples

Terminal window
wiqd publish pc resume --operation <value>
wiqd publish pc resume --operation <value> --path <value> --listing <value>
wiqd publish pc resume --operation <value> --json

Read real job/submission/resource-tree state for the selected Product or configure job.

Extension: Partner Center Publishing Foundation

Terminal window
wiqd publish pc status [options]

Options

OptionDescription
--path <value>Project context (default .).
--listing <value>Binding context (default partner-center.json); read when no other selector is given.
--product-id <value>Canonical product/ to read status for.
--job-id <value>Configure job ID to read status for.
--watchPoll until a terminal state is reached instead of a single read.

Examples

Terminal window
wiqd publish pc status
wiqd publish pc status --path <value> --listing <value>
wiqd publish pc status --json

Submit a prepared Draft for certification. Requires —yes AND either —interactive with typed confirmation at a real terminal or —authorize-submit for unattended authorization. Re-verifies the exact prepared Draft before dispatch.

Extension: Partner Center Publishing Foundation

Terminal window
wiqd publish pc submit [options]

Options

OptionDescription
--path <value>Project context (default .).
--listing <value>Listing file read for the prepared Product ID (default partner-center.json).
--product-id <value>Canonical product/ of the Product to submit; must match the Product recorded by a prior pc prepare.
--yesRequired ordinary-preparation confirmation, identical gating to pc prepare. Does NOT by itself authorize submission, accept legal terms, or establish Live intent — choose —interactive or —authorize-submit.
--interactiveIn addition to —yes, requests an explicit “submit” confirmation at a real terminal after Draft verification. Choose this or —authorize-submit, not both.
--authorize-submitIn addition to —yes, explicitly authorizes submission of the verified Draft for this invocation without a prompt. Mutually exclusive with —interactive. Does not grant authentication or bypass certification.

Examples

Terminal window
wiqd publish pc submit --product-id <value>
wiqd publish pc submit --product-id <value> --path <value> --listing <value>
wiqd publish pc submit --product-id <value> --json

Preview or apply selected listing fields, package changes and media to the offer bound in partner-center.json. Run in the project/appPackage directory or select —path. Every applied update carries a higher-version package; never submits.

Extension: Partner Center Publishing Foundation

Terminal window
wiqd publish pc update [options]

Options

OptionDescription
--path <value>Project root or its appPackage directory (default current directory). Reads the offer’s Product ID from partner-center.json.
--listing <value>Listing file bound to the offer (default partner-center.json).
--fields <value>Comma-separated partner-center.json fields to update: listing.title, listing.description, listing.searchResultSummary, listing.categories, listing.legal.privacyPolicyUrl, listing.legal.supportDocumentUrl, listing.legal.termsConditions, listing.legal.termsOfUseUrl, listing.certification.notesToReviewer, availabilityDate. Unselected fields are preserved.
--update-packageRebuild and replace the package from the local project even without listing or media changes. Manifest descriptions do not overwrite store descriptions.
--package <value>Project-contained prebuilt ZIP instead of a fresh build. Its manifest version must exceed the local manifest and recorded successful updates; source ZIP and local manifest are unchanged.
--package-env <value>Agent lifecycle environment used to build a fresh ZIP when —package is omitted. (default: “local”)
--release-notes <value>Submission input required with —package; does not change Draft listing fields or submit.
--availability-date <value>ISO timestamp with seconds and timezone; requires —fields availabilityDate.
--listing-onlyStates that only listing content changed. The package version is still bumped and the package rebuilt.
--dry-runRead the offer and show what an update would do, including the proposed package version. Writes nothing.
--logoUpdate only the listing logo selected by assets.logo in partner-center.json; app-package icons are not edited.
--screenshotsUpload the screenshots in partner-center.json, up to five total on the resulting listing. Ask the user whether to add or replace before choosing —screenshot-mode.
--screenshot-mode <value>add preserves existing screenshots; replace replaces the set. Requires —screenshots. If omitted, —interactive asks the user in a real terminal.
--yesApply explicitly selected fields/media and the required package to Draft. Never submits.
--submitAlso submit the updated Draft for certification. Requires —yes and —interactive. Not supported yet.
--interactiveAsk add versus replace for screenshots in a real terminal when —screenshot-mode is omitted. Never authorizes submission.

Examples

Terminal window
wiqd publish pc update
wiqd publish pc update --path <value> --listing <value>
wiqd publish pc update --json

Update wiqd to the latest version

Extension: wiqd (core)

Terminal window
wiqd update [options]

Options

OptionDescription
--version <version>Install specific version
--checkCheck for updates without installing
--channel <channel>Release channel: latest, preview, dev (npm alpha)
--forceDeprecated: update always reinstalls; kept for compatibility
--dry-runShow what would be done without doing it
--skip-extensionSkip VS Code extension update
--skip-pluginSkip installer-owned plugin updates

Examples

Terminal window
wiqd update
wiqd update --version <version> --channel <channel>
wiqd update --json

The CLI can update successfully even if an optional VS Code extension or Copilot/Claude plugin could not be set up. In that case, you can keep using wiqd, but the affected integration may not be ready.

If you see Some optional setup did not complete., read the details below the warning and rerun the displayed installer command to retry setup. You do not need a special flag to continue using the CLI.

Use --skip-plugin to skip plugin setup, or --skip-extension to skip the VS Code extension. Errors that prevent the CLI itself from being installed still fail the update. With --json, any setup warnings and retry commands are included in data.warnings.

Feature flags are typed toggles that gate experimental or environment-specific CLI behavior. The host registry defines cross-extension flags, and active extensions contribute capability flags (for example devui from the DevUI extension). They resolve with strict precedence — env var > persisted > registry default — where the env var name is WIQD_FLAG_<UPPER_SNAKE_CASE_NAME> (so workiq-monitor is overridden by WIQD_FLAG_WORKIQ_MONITOR). Persisted values live under the "flags" key in ~/.wiqd/.wiqd.json and are never sent in telemetry. Manage flags with wiqd config flags list|show|set|reset.

wiqd agent add skill is behind the agent-skills flag (declared by the core FxCore extension, off by default): the declarative-agent skills manifest schema is not yet worldwide (WW), so the command stays opt-in until it is. Enable it with wiqd config flags set agent-skills true or the WIQD_FLAG_AGENT_SKILLS env var.

Flag changes do not trigger a plugin reinstall.

FlagTypeDefaultStageOwnerSinceDescription
frontierbooleanfalsealphawiqd-core0.14.0Enables preview capabilities across wiqd and participating extensions.
agent-skillsbooleanfalsebetamicrosoft.wiqd.core0.12.2Enables wiqd agent add skill and fx-core inclusion of DA-only agent_skills folders during agent/plugin package, provision, and publish. The DA manifest schema for skills is not yet worldwide (WW); off by default until the schema is generally available.
devuibooleanfalsebetamicrosoft.devui0.5.0Enables the wiqd devui commands (the local Work IQ DevUI web experience). Opt-in while the experience is in preview.
partner-center-publishingbooleantruealphamicrosoft.marketplace0.17.0Expose Marketplace authentication and Partner Center publishing (real REST/MCP actions for init, preflight, prepare, submit, status, and composed publish; static access guidance; simulated resume).
workiq-monitorbooleantruebetamicrosoft.workiq0.2.2Enables the wiqd agent monitor command (Insights Agent query) inside the Work IQ extension. On by default; can be set to false to hide the command. plugin ask --component agent and agent list are always available.

Every registered flag has a corresponding env var of the form WIQD_FLAG_<UPPER_SNAKE_CASE_NAME>:

FlagEnv var
frontierWIQD_FLAG_FRONTIER
agent-skillsWIQD_FLAG_AGENT_SKILLS
devuiWIQD_FLAG_DEVUI
partner-center-publishingWIQD_FLAG_PARTNER_CENTER_PUBLISHING
workiq-monitorWIQD_FLAG_WORKIQ_MONITOR