Command reference
Command reference
Section titled “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
Section titled “Exit codes”Exit codes are not repeated per command. Every wiqd command follows the
standard convention:
| Code | Meaning |
|---|---|
0 | Success |
1 | User or upstream error (bad input, tool failure, postcondition failure) |
2 | Configuration or infrastructure error (binary missing, version mismatch, not a project, or a required provider definitively reports signed out) |
130 | Cancelled (Ctrl+C) |
See Exit codes & output for the full contract.
Host plugin lifecycle
Section titled “Host plugin lifecycle”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.
Local diagnostic evidence
Section titled “Local diagnostic evidence”Before changing a failing installation, collect its existing local state:
wiqd diagnostics collect --output ./incident.json.gz --jsonwiqd diagnostics collect --output ./incident-with-log.json.gz --log ./incident.ndjsonThe 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.
Global options
Section titled “Global options”These options are accepted by every command and are omitted from the per-command tables below.
| Option | Description |
|---|---|
-v, --version | Output the version number and exit |
--json | Emit machine-readable JSON output (default is a human-readable table) (default: false) |
--verbose | Show verbose output (default: false) |
--no-banner | Suppress 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, --help | display help for command |
Command index
Section titled “Command index”wiqd agent
| Command | Extension | Description |
|---|---|---|
wiqd agent | wiqd (core) | Configure embedded agents and inspect deployed declarative agents |
wiqd agent add | wiqd Core | Augment an existing declarative agent with an action, skill, or auth config. |
wiqd agent add action | wiqd Core | Add an OpenAPI or remote MCP action to a declarative agent. |
wiqd agent add auth | wiqd Core | Add an auth configuration to a plugin manifest. |
wiqd agent add skill | wiqd Core | Add a skill to a declarative agent. |
wiqd agent eval | Copilot Eval | Run quality evaluations against a deployed declarative agent. |
wiqd agent eval init | Copilot Eval | Initialize an evaluation prompts.json for a project (drops a fixed seven-item bootstrap for the default declarative-agent template, plus env/.env. |
wiqd agent info | wiqd Core | 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. |
wiqd agent list | Work IQ | List declarative agents deployed in the tenant. |
wiqd agent monitor | Work IQ | Query the Insights Agent about a provisioned agent’s performance and usage. |
wiqd agent show | Work IQ | Retrieve the real Work IQ A2A agent card by deployed agent ID or name. |
wiqd auth
| Command | Extension | Description |
|---|---|---|
wiqd auth | wiqd (core) | Manage authentication for wiqd and its extensions |
wiqd auth login | wiqd (core) | Sign in to all active auth providers (requires a terminal) |
wiqd auth logout | wiqd (core) | Sign out of wiqd services |
wiqd auth status | wiqd (core) | Show authentication status |
wiqd auth token | wiqd Core | token |
wiqd auth token get | wiqd Core | 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. |
wiqd changelog
| Command | Extension | Description |
|---|---|---|
wiqd changelog | wiqd (core) | Show wiqd release changelog |
wiqd completion
| Command | Extension | Description |
|---|---|---|
wiqd completion | wiqd (core) | Output a shell tab-completion script (bash, zsh, powershell, fish) |
wiqd component
| Command | Extension | Description |
|---|---|---|
wiqd component | wiqd (core) | Manage the Work IQ VS Code extension |
wiqd component vscode | wiqd (core) | Manage the Work IQ VS Code extension |
wiqd component vscode info | wiqd (core) | Report the VS Code extension install location (stable + insiders) |
wiqd component vscode install | wiqd (core) | Install the VS Code extension |
wiqd component vscode uninstall | wiqd (core) | Uninstall the VS Code extension |
wiqd config
| Command | Extension | Description |
|---|---|---|
wiqd config | wiqd (core) | Manage wiqd configuration settings |
wiqd config flags | wiqd (core) | Manage wiqd feature flags |
wiqd config flags list | wiqd (core) | List all registered feature flags and their resolved values |
wiqd config flags reset | wiqd (core) | Clear a persisted feature flag value |
wiqd config flags set | wiqd (core) | Persist a feature flag value |
wiqd config flags show | wiqd (core) | Show definition and resolved value for a single feature flag |
wiqd config reset | wiqd (core) | Reset all configuration to defaults |
wiqd config set | wiqd (core) | Set configuration values |
wiqd connector
| Command | Extension | Description |
|---|---|---|
wiqd connector | wiqd (core) | Discover catalog connectors and create MCP or REST API connectors |
wiqd connector add | wiqd Core | Create a connector for a remote MCP server or Swagger 2.0 REST API through production MCP Platform. |
wiqd connector list | wiqd Core | Discover remote MCP and preview OpenAPI connectors from the Microsoft 365 catalog. |
wiqd connector show | wiqd Core | Show a canonical catalog agentConnector node. |
wiqd devui
| Command | Extension | Description |
|---|---|---|
wiqd devui | wiqd (core) | Launch the local Work IQ DevUI web experience |
wiqd devui ask | Work IQ DevUI | Ask an agent and watch the turn run live in the local Work IQ DevUI (deep-linked + auto-sent). |
wiqd devui config | Work IQ DevUI | Configure 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 start | Work IQ DevUI | Start (or reuse) the local Work IQ DevUI and open it in the browser. |
wiqd devui stop | Work IQ DevUI | Stop the running local Work IQ DevUI (release its server and the install-directory lock). |
wiqd diagnostics
| Command | Extension | Description |
|---|---|---|
wiqd diagnostics | wiqd (core) | Collect local diagnostics without changing the installation |
wiqd diagnostics collect | wiqd (core) | Write a private, read-only diagnostic evidence archive |
wiqd doctor
| Command | Extension | Description |
|---|---|---|
wiqd doctor | wiqd (core) | Check environment health (Node.js, extensions, auth) |
wiqd eula
| Command | Extension | Description |
|---|---|---|
wiqd eula | wiqd (core) | Accept or report WIQD and downstream-tool End User License Agreements (EULAs) |
wiqd eula accept | wiqd (core) | Accept one tool’s EULA through the human-confirmed acceptance path |
wiqd eula status | wiqd (core) | Report EULA-acceptance state for all EULA-gated tools |
wiqd exec
| Command | Extension | Description |
|---|---|---|
wiqd exec | wiqd (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
| Command | Extension | Description |
|---|---|---|
wiqd ext | wiqd (core) | Manage installed wiqd extensions |
wiqd ext add | wiqd (core) | Activate an installed extension (registers it in ~/.wiqd/extensions.json) |
wiqd ext list | wiqd (core) | List discovered and registered extensions |
wiqd ext remove | wiqd (core) | Deactivate an extension (removes it from ~/.wiqd/extensions.json) |
wiqd ext show | wiqd (core) | Show extension details |
wiqd feedback
| Command | Extension | Description |
|---|---|---|
wiqd feedback | wiqd (core) | List and submit feedback about wiqd |
wiqd feedback list | GitHub | List feedback you submitted through wiqd. |
wiqd feedback submit | GitHub | Submit feedback about wiqd as a GitHub issue. |
wiqd marketplace
| Command | Extension | Description |
|---|---|---|
wiqd marketplace | wiqd (core) | Install the public WIQD plugin through a supported host’s native marketplace. |
wiqd marketplace setup | wiqd Core | 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. |
wiqd plugin
| Command | Extension | Description |
|---|---|---|
wiqd plugin | wiqd (core) | Build, validate, package, and publish standalone plugins (agent + skills + connector) |
wiqd plugin add | wiqd Core | add |
wiqd plugin add agent | wiqd Core | Compose one declarative agent into an existing plugin without replacing plugin-owned files. |
wiqd plugin add collaborator | wiqd Core | Add and read-back verify one M365 plugin title co-owner. |
wiqd plugin add connector | wiqd Core | Add a catalog connector (—selector), a remote MCP connector, or an OpenAPI custom connector to the plugin manifest. |
wiqd plugin add environment | wiqd Core | Copy an existing plugin environment to a new name. |
wiqd plugin add market-listing | Validation & LSP | 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. |
wiqd plugin add skill | wiqd Core | Scaffold a SKILL.md skill folder and register it in the plugin manifest. |
wiqd plugin ask | Work IQ | Send a message directly to a declarative agent component. |
wiqd plugin create | wiqd Core | Scaffold a new, empty standalone plugin project from the built-in blank app template. |
wiqd plugin delete | wiqd Core | 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. |
wiqd plugin export | wiqd Core | Export a plugin project to Open Plugin (or Claude/Cursor) format. |
wiqd plugin get | Validation & LSP | Get plugin resources. |
wiqd plugin get market-listing | Validation & LSP | 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. |
wiqd plugin import | wiqd Core | Import an Open Plugin (or Claude/Cursor plugin) as a new plugin project. |
wiqd plugin list | wiqd Core | List standalone plugin projects under a directory. |
wiqd plugin list collaborators | wiqd Core | List verified co-owners for the selected M365 plugin title, including standalone plugins. |
wiqd plugin list environments | wiqd Core | List environments from the lifecycle-configured environment folder. |
wiqd plugin list templates | wiqd Core | List supported templates for ‘wiqd plugin add agent’. |
wiqd plugin package | wiqd Core | Package the plugin into a .zip. Use —offline for a local-only preview connector/skill package without provisioning or server validation. |
wiqd plugin preview | Validation & LSP | Preview plugin resources. |
wiqd plugin preview market-listing | Validation & LSP | 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. |
wiqd plugin provision | wiqd Core | Provision 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 package | wiqd Core | Prepare or personally sideload a final DA or supported MCP connector ZIP without a source project. |
wiqd plugin publish | wiqd Core | Submit a provisioned plugin to the tenant organization app catalog for administrator approval. Requires Microsoft 365 sign-in; use wiqd auth login --interactive. |
wiqd plugin remove | wiqd Core | Remove plugin access. |
wiqd plugin remove access | wiqd Core | Remove plugin usage or existing shared-access grants. This is not title co-owner removal. |
wiqd plugin repair | Validation & LSP | Repair plugin artifacts. |
wiqd plugin repair package | Validation & LSP | Apply explicit hash-bound replacements to a new ZIP without a source project. Preserves the original; does not validate or publish. |
wiqd plugin reset | wiqd Core | Reset plugin state. |
wiqd plugin reset environment | wiqd Core | Reset a plugin environment and its optional .user sidecar. |
wiqd plugin share | wiqd Core | Share a plugin with users or the entire tenant. Requires Microsoft 365 sign-in; use wiqd auth login --interactive. |
wiqd plugin show | wiqd Core | Show complete offline details for a local plugin and its optional embedded agent. |
wiqd plugin validate | Validation & LSP | 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. |
wiqd policy
| Command | Extension | Description |
|---|---|---|
wiqd policy | wiqd (core) | Work IQ maker-policy operations |
wiqd policy publish | wiqd Core | Publish Work IQ policy for an existing title through the native SDK. Requires a compatible SDK and prior Microsoft 365 sign-in. |
wiqd publish
| Command | Extension | Description |
|---|---|---|
wiqd publish | wiqd (core) | Publish prepared packages to a registry or marketplace |
wiqd publish pc | Partner Center Publishing Foundation | 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. |
wiqd publish pc access | Partner Center Publishing Foundation | Show static Marketplace publisher setup guidance; WIQD cannot verify publishing readiness at this time. |
wiqd publish pc init | Partner Center Publishing Foundation | Scaffold or read partner-center.json for this project; optionally verifies —product-id against the real Product. |
wiqd publish pc preflight | Partner Center Publishing Foundation | Read the real Product/resource-tree and classify the proposed change (listing-only vs. package/version impact). |
wiqd publish pc prepare | Partner Center Publishing Foundation | Create/update the real Draft: configure listing fields, upload package/assets via MCP, and record the Product ID locally. |
wiqd publish pc resume | Partner Center Publishing Foundation | Show a synthetic resume result; no operation is read, reconciled, or continued. |
wiqd publish pc status | Partner Center Publishing Foundation | Read real job/submission/resource-tree state for the selected Product or configure job. |
wiqd publish pc submit | Partner Center Publishing Foundation | 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. |
wiqd publish pc update | Partner Center Publishing Foundation | 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. |
wiqd update
| Command | Extension | Description |
|---|---|---|
wiqd update | wiqd (core) | Update wiqd to the latest version |
wiqd agent
Section titled “wiqd agent”Configure embedded agents and inspect deployed declarative agents
Extension: wiqd (core)
wiqd agent <command>Examples
wiqd agentwiqd agent addwiqd agent --helpwiqd agent add
Section titled “wiqd agent add”Augment an existing declarative agent with an action, skill, or auth config.
Extension: wiqd Core
wiqd agent add <command>Examples
wiqd agent add actionwiqd agent add skillwiqd agent add authwiqd agent add --helpwiqd agent add action
Section titled “wiqd agent add action”Add an OpenAPI or remote MCP action to a declarative agent.
Extension: wiqd Core
wiqd agent add action [options]Options
| Option | Description |
|---|---|
--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-pkce | Enable PKCE for generic OAuth (default: false) |
-f, --folder <value> | Project folder |
Examples
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> --jsonwiqd agent add auth
Section titled “wiqd agent add auth”Add an auth configuration to a plugin manifest.
Extension: wiqd Core
wiqd agent add auth [options]Options
| Option | Description |
|---|---|
--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-pkce | Enable 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
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-tokenwiqd agent add auth --plugin-manifest <value> --auth-name <value> --jsonwiqd agent add skill
Section titled “wiqd agent add skill”Add a skill to a declarative agent.
Extension: wiqd Core
wiqd agent add skill [options]Options
| Option | Description |
|---|---|
--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
wiqd agent add skillwiqd agent add skill --name <value> --description <value>wiqd agent add skill --jsonwiqd agent eval
Section titled “wiqd agent eval”Run quality evaluations against a deployed declarative agent.
Extension: Copilot Eval
wiqd agent eval [options] <command>Options
| Option | Description |
|---|---|
--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
wiqd agent evalwiqd agent eval --env <value> --path <value>wiqd agent eval --helpwiqd agent eval init
Section titled “wiqd agent eval init”Initialize an evaluation prompts.json for a project (drops a fixed seven-item bootstrap for the default declarative-agent template, plus env/.env.
Extension: Copilot Eval
wiqd agent eval init [options]Options
| Option | Description |
|---|---|
--path <value> | Project path (defaults to CWD) |
--env <value> | Target environment (controls env/.env. |
--output <value> | Output prompts file (runevals auto-discovers evals/prompts.json) (default: “evals/prompts.json”) |
Examples
wiqd agent eval initwiqd agent eval init --path <value> --env <value>wiqd agent eval init --jsonwiqd agent info
Section titled “wiqd agent info”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
wiqd agent info [options]Options
| Option | Description |
|---|---|
--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
wiqd agent infowiqd agent info --agent-id <value> --title-id <value>wiqd agent info --jsonwiqd agent list
Section titled “wiqd agent list”List declarative agents deployed in the tenant.
Extension: Work IQ
wiqd agent list [options]Options
| Option | Description |
|---|---|
--name <value> | Filter by name (substring) |
--id <value> | Filter by ID (substring) |
--top <value> | Maximum number of results |
Examples
wiqd agent listwiqd agent list --name <value> --id <value>wiqd agent list --jsonwiqd agent monitor
Section titled “wiqd agent monitor”Query the Insights Agent about a provisioned agent’s performance and usage.
Extension: Work IQ
wiqd agent monitor [options]Options
| Option | Description |
|---|---|
-q, --query <value> | Natural language query |
--env <value> | Target environment (default: “local”) |
--path <value> | Project path (or run standalone) |
Examples
wiqd agent monitorwiqd agent monitor --query <value> --env <value>wiqd agent monitor --jsonwiqd agent show
Section titled “wiqd agent show”Retrieve the real Work IQ A2A agent card by deployed agent ID or name.
Extension: Work IQ
wiqd agent show [options]Options
| Option | Description |
|---|---|
--id <value> | Deployed agent ID (takes precedence over —name) |
--name <value> | Deployed agent name |
Examples
wiqd agent show --id <deployed-agent-id>wiqd agent show --name "<deployed-agent-name>"wiqd agent show --id <deployed-agent-id> --jsonwiqd auth
Section titled “wiqd auth”Manage authentication for wiqd and its extensions
Extension: wiqd (core)
wiqd auth <command>Examples
wiqd authwiqd auth loginwiqd auth --helpwiqd auth login
Section titled “wiqd auth login”Sign in to all active auth providers (requires a terminal)
Extension: wiqd (core)
wiqd auth login [options]Options
| Option | Description |
|---|---|
--interactive | Allow 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
wiqd auth loginwiqd auth login --tenant <tenant-id> --interactivewiqd auth login --jsonwiqd auth logout
Section titled “wiqd auth logout”Sign out of wiqd services
Extension: wiqd (core)
wiqd auth logoutExamples
wiqd auth logoutwiqd auth logout --jsonwiqd auth status
Section titled “wiqd auth status”Show authentication status
Extension: wiqd (core)
wiqd auth statusExamples
wiqd auth statuswiqd auth status --jsonwiqd auth token
Section titled “wiqd auth token”token
Extension: wiqd Core
wiqd auth token <command>Examples
wiqd auth tokenwiqd auth token getwiqd auth token --helpwiqd auth token get
Section titled “wiqd auth token get”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
wiqd auth token get [options]Options
| Option | Description |
|---|---|
--tenant <value> | Microsoft Entra tenant GUID |
--show-token | Request one terminal disclosure after human confirmation (never JSON or CI) (default: false) |
Examples
wiqd auth token getwiqd auth token get --tenant <value> --show-tokenwiqd auth token get --jsonwiqd changelog
Section titled “wiqd changelog”Show wiqd release changelog
Extension: wiqd (core)
wiqd changelog [options]Options
| Option | Description |
|---|---|
--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 |
--markdown | Emit canonical markdown (paste-ready; never ANSI-rendered) |
--no-markdown-render | Disable inline markdown rendering in text output (always raw markdown) |
Examples
wiqd changelog # the latest releasewiqd changelog --version <version> # one specific releasewiqd changelog --from <version> # everything AFTER that releasewiqd completion
Section titled “wiqd completion”Output a shell tab-completion script (bash, zsh, powershell, fish)
Extension: wiqd (core)
wiqd completion shellArguments
| Argument | Description |
|---|---|
shell | Target shell: bash, zsh, powershell, or fish |
Examples
wiqd completion <shell>wiqd completion <shell> --jsonwiqd component
Section titled “wiqd component”Manage the Work IQ VS Code extension
Extension: wiqd (core)
wiqd component <command>Examples
wiqd componentwiqd component vscodewiqd component --helpwiqd component vscode
Section titled “wiqd component vscode”Manage the Work IQ VS Code extension
Extension: wiqd (core)
wiqd component vscode <command>Examples
wiqd component vscodewiqd component vscode infowiqd component vscode installwiqd component vscode uninstallwiqd component vscode --helpwiqd component vscode info
Section titled “wiqd component vscode info”Report the VS Code extension install location (stable + insiders)
Extension: wiqd (core)
wiqd component vscode infoExamples
wiqd component vscode infowiqd component vscode info --jsonwiqd component vscode install
Section titled “wiqd component vscode install”Install the VS Code extension
Extension: wiqd (core)
wiqd component vscode install [options]Options
| Option | Description |
|---|---|
--insiders | Target VS Code Insiders instead of stable |
--force | Reinstall even if already present |
Examples
wiqd component vscode installwiqd component vscode install --insiders --forcewiqd component vscode install --jsonwiqd component vscode uninstall
Section titled “wiqd component vscode uninstall”Uninstall the VS Code extension
Extension: wiqd (core)
wiqd component vscode uninstall [options]Options
| Option | Description |
|---|---|
--insiders | Target VS Code Insiders instead of stable |
Examples
wiqd component vscode uninstallwiqd component vscode uninstall --insiderswiqd component vscode uninstall --jsonwiqd config
Section titled “wiqd config”Manage wiqd configuration settings
Extension: wiqd (core)
wiqd config <command>Examples
wiqd configwiqd config flagswiqd config resetwiqd config setwiqd config --helpwiqd config flags
Section titled “wiqd config flags”Manage wiqd feature flags
Extension: wiqd (core)
wiqd config flags <command>Examples
wiqd config flagswiqd config flags listwiqd config flags --helpwiqd config flags list
Section titled “wiqd config flags list”List all registered feature flags and their resolved values
Extension: wiqd (core)
wiqd config flags list [options]Options
| Option | Description |
|---|---|
--enabled-only | Show only boolean flags currently evaluating true (default: false) |
Examples
wiqd config flags listwiqd config flags list --enabled-onlywiqd config flags list --jsonwiqd config flags reset
Section titled “wiqd config flags reset”Clear a persisted feature flag value
Extension: wiqd (core)
wiqd config flags reset name [options]Arguments
| Argument | Description |
|---|---|
name | Flag name (mutually exclusive with —all) |
Options
| Option | Description |
|---|---|
--all | Clear all persisted feature flag values (default: false) |
Examples
wiqd config flags resetwiqd config flags reset --allwiqd config flags reset [name]wiqd config flags set
Section titled “wiqd config flags set”Persist a feature flag value
Extension: wiqd (core)
wiqd config flags set name valueArguments
| Argument | Description |
|---|---|
name | Flag name |
value | Value to persist (validated against the flag type) |
Examples
wiqd config flags set <name> <value>wiqd config flags set <name> <value> --jsonwiqd config flags show
Section titled “wiqd config flags show”Show definition and resolved value for a single feature flag
Extension: wiqd (core)
wiqd config flags show nameArguments
| Argument | Description |
|---|---|
name | Flag name (e.g. my-flag) |
Examples
wiqd config flags show <name>wiqd config flags show <name> --jsonwiqd config reset
Section titled “wiqd config reset”Reset all configuration to defaults
Extension: wiqd (core)
wiqd config resetExamples
wiqd config resetwiqd config reset --jsonwiqd config set
Section titled “wiqd config set”Set configuration values
Extension: wiqd (core)
wiqd config set pairsArguments
| Argument | Description |
|---|---|
pairs | Key=value pairs to set |
Examples
wiqd config setwiqd config set [pairs...]wiqd connector
Section titled “wiqd connector”Discover catalog connectors and create MCP or REST API connectors
Extension: wiqd (core)
wiqd connector <command>Examples
wiqd connectorwiqd connector addwiqd connector listwiqd connector showwiqd connector --helpwiqd connector add
Section titled “wiqd connector add”Create a connector for a remote MCP server or Swagger 2.0 REST API through production MCP Platform.
Extension: wiqd Core
wiqd connector add [options]Options
| Option | Description |
|---|---|
--input-file <value> | Private JSON with displayName, authentication and either serverUrl (MCP) or apiDefinition (Swagger 2.0) |
--dry-run | Validate input offline without authentication or creation |
Examples
wiqd connector add --input-file <value>wiqd connector add --input-file <value> --dry-runwiqd connector add --input-file <value> --jsonwiqd connector list
Section titled “wiqd connector list”Discover remote MCP and preview OpenAPI connectors from the Microsoft 365 catalog.
Extension: wiqd Core
wiqd connector list [options]Options
| Option | Description |
|---|---|
--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
wiqd connector listwiqd connector list --search <value> --auth-type <value>wiqd connector list --jsonwiqd connector show
Section titled “wiqd connector show”Show a canonical catalog agentConnector node.
Extension: wiqd Core
wiqd connector show selectorArguments
| Argument | Description |
|---|---|
selector | Selector emitted by ‘connector list’ |
Examples
wiqd connector showwiqd connector show [selector]wiqd devui
Section titled “wiqd devui”Launch the local Work IQ DevUI web experience
Extension: wiqd (core)
wiqd devui <command>Examples
wiqd devuiwiqd devui askwiqd devui --helpwiqd devui ask
Section titled “wiqd devui ask”Ask an agent and watch the turn run live in the local Work IQ DevUI (deep-linked + auto-sent).
Extension: Work IQ DevUI
wiqd devui ask [options]Options
| Option | Description |
|---|---|
-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-open | Do not open a browser; print the URL instead |
Examples
wiqd devui ask --query <value>wiqd devui ask --query <value> --agent <value> --transport directwiqd devui ask --query <value> --jsonwiqd devui config
Section titled “wiqd devui config”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
wiqd devui config [options]Options
| Option | Description |
|---|---|
--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) |
--clear | Clear the client id and fall back to the workiq CLI |
Examples
wiqd devui configwiqd devui config --client-id <value> --tenant <value>wiqd devui config --jsonwiqd devui start
Section titled “wiqd devui start”Start (or reuse) the local Work IQ DevUI and open it in the browser.
Extension: Work IQ DevUI
wiqd devui start [options]Options
| Option | Description |
|---|---|
--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-send | With —query, prefill the composer without auto-sending |
--no-open | Do not open a browser; print the URL instead |
--no-window | Never open a separate console window (Windows); run the server headless |
Examples
wiqd devui startwiqd devui start --agent <value> --transport directwiqd devui start --jsonwiqd devui stop
Section titled “wiqd devui stop”Stop the running local Work IQ DevUI (release its server and the install-directory lock).
Extension: Work IQ DevUI
wiqd devui stop [options]Options
| Option | Description |
|---|---|
--port <value> | Loopback port the DevUI is served on (default: 7317) |
Examples
wiqd devui stopwiqd devui stop --port <value>wiqd devui stop --jsonwiqd diagnostics
Section titled “wiqd diagnostics”Collect local diagnostics without changing the installation
Extension: wiqd (core)
wiqd diagnostics <command>Examples
wiqd diagnosticswiqd diagnostics collectwiqd diagnostics --helpwiqd diagnostics collect
Section titled “wiqd diagnostics collect”Write a private, read-only diagnostic evidence archive
Extension: wiqd (core)
wiqd diagnostics collect [options]Options
| Option | Description |
|---|---|
--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
wiqd diagnostics collect --output <archive.json.gz>wiqd diagnostics collect --output <archive.json.gz> --log <file>wiqd diagnostics collect --output <archive.json.gz> --jsonwiqd doctor
Section titled “wiqd doctor”Check environment health (Node.js, extensions, auth)
Extension: wiqd (core)
wiqd doctorExamples
wiqd doctorwiqd doctor --jsonwiqd eula
Section titled “wiqd eula”Accept or report WIQD and downstream-tool End User License Agreements (EULAs)
Extension: wiqd (core)
wiqd eula <command>Examples
wiqd eulawiqd eula acceptwiqd eula statuswiqd eula --helpwiqd eula accept
Section titled “wiqd eula accept”Accept one tool’s EULA through the human-confirmed acceptance path
Extension: wiqd (core)
wiqd eula accept tool [options]Arguments
| Argument | Description |
|---|---|
tool | The EULA-gated tool to accept (run wiqd eula status to list them) |
Options
| Option | Description |
|---|---|
--yes | Accept 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
wiqd eula accept <tool>wiqd eula accept <tool> --consent <phrase> --yeswiqd eula accept <tool> --jsonwiqd eula status
Section titled “wiqd eula status”Report EULA-acceptance state for all EULA-gated tools
Extension: wiqd (core)
wiqd eula statusExamples
wiqd eula statuswiqd eula status --jsonwiqd exec
Section titled “wiqd exec”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)
wiqd exec cli argsArguments
| Argument | Description |
|---|---|
cli | Name of the managed CLI to run (e.g. workiq) |
args | Arguments forwarded to the CLI unchanged |
Examples
wiqd exec <cli> --helpwiqd exec <cli> <subcommand> [args...]wiqd exec <cli> <subcommand> -- --json # forward a flag that collides with a wiqd globalwiqd ext
Section titled “wiqd ext”Manage installed wiqd extensions
Extension: wiqd (core)
wiqd ext <command>Examples
wiqd extwiqd ext addwiqd ext --helpwiqd ext add
Section titled “wiqd ext add”Activate an installed extension (registers it in ~/.wiqd/extensions.json)
Extension: wiqd (core)
wiqd ext add idArguments
| Argument | Description |
|---|---|
id | Extension manifest ID or npm package name |
Examples
wiqd ext add <id>wiqd ext add <id> --jsonwiqd ext list
Section titled “wiqd ext list”List discovered and registered extensions
Extension: wiqd (core)
wiqd ext listExamples
wiqd ext listwiqd ext list --jsonwiqd ext remove
Section titled “wiqd ext remove”Deactivate an extension (removes it from ~/.wiqd/extensions.json)
Extension: wiqd (core)
wiqd ext remove idArguments
| Argument | Description |
|---|---|
id | Extension manifest ID or npm package name |
Examples
wiqd ext remove <id>wiqd ext remove <id> --jsonwiqd ext show
Section titled “wiqd ext show”Show extension details
Extension: wiqd (core)
wiqd ext show idArguments
| Argument | Description |
|---|---|
id | Extension ID |
Examples
wiqd ext show <id>wiqd ext show <id> --jsonwiqd feedback
Section titled “wiqd feedback”List and submit feedback about wiqd
Extension: wiqd (core)
wiqd feedback <command>Examples
wiqd feedbackwiqd feedback listwiqd feedback submitwiqd feedback --helpwiqd feedback list
Section titled “wiqd feedback list”List feedback you submitted through wiqd.
Extension: GitHub
wiqd feedback list [options]Options
| Option | Description |
|---|---|
-n, --top <value> | Number of items to show |
--status <value> | Filter by status (open, closed, all) |
Examples
wiqd feedback listwiqd feedback list --top <value> --status <value>wiqd feedback list --jsonwiqd feedback submit
Section titled “wiqd feedback submit”Submit feedback about wiqd as a GitHub issue.
Extension: GitHub
wiqd feedback submit [options]Options
| Option | Description |
|---|---|
--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-context | Omit auto-collected environment context |
--dry-run | Show what would be submitted |
Examples
wiqd feedback submitwiqd feedback submit --type <value> --title <value>wiqd feedback submit --jsonwiqd marketplace
Section titled “wiqd marketplace”Install the public WIQD plugin through a supported host’s native marketplace.
Extension: wiqd (core)
wiqd marketplace <command>Examples
wiqd marketplacewiqd marketplace setupwiqd marketplace --helpwiqd marketplace setup
Section titled “wiqd marketplace setup”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
wiqd marketplace setup [options]Options
| Option | Description |
|---|---|
--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-run | Inspect native state and report planned actions without changing it (default: false) |
Examples
wiqd marketplace setupwiqd marketplace setup --host <value> --marketplace <value>wiqd marketplace setup --jsonwiqd plugin
Section titled “wiqd plugin”Build, validate, package, and publish standalone plugins (agent + skills + connector)
Extension: wiqd (core)
wiqd plugin <command>Examples
wiqd pluginwiqd plugin addwiqd plugin --helpwiqd plugin add
Section titled “wiqd plugin add”add
Extension: wiqd Core
wiqd plugin add <command>Examples
wiqd plugin addwiqd plugin add agentwiqd plugin add --helpwiqd plugin add agent
Section titled “wiqd plugin add agent”Compose one declarative agent into an existing plugin without replacing plugin-owned files.
Extension: wiqd Core
wiqd plugin add agent [options]Options
| Option | Description |
|---|---|
-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
wiqd plugin add agentwiqd plugin add agent --template declarative-agent --name <value>wiqd plugin add agent --jsonwiqd plugin add collaborator
Section titled “wiqd plugin add collaborator”Add and read-back verify one M365 plugin title co-owner.
Extension: wiqd Core
wiqd plugin add collaborator [options]Options
| Option | Description |
|---|---|
--email <value> | One directory email or UPN |
--env <value> | Target environment (default: “local”) |
--path <value> | Plugin project path (defaults to CWD) |
Examples
wiqd plugin add collaborator --email <value>wiqd plugin add collaborator --email <value> --env <value> --path <value>wiqd plugin add collaborator --email <value> --jsonwiqd plugin add connector
Section titled “wiqd plugin add connector”Add a catalog connector (—selector), a remote MCP connector, or an OpenAPI custom connector to the plugin manifest.
Extension: wiqd Core
wiqd plugin add connector [options]Options
| Option | Description |
|---|---|
--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-preview | Explicitly move the manifest to devPreview for OpenAPI or inferred remote MCP ConnectionVault |
-f, --folder <value> | Plugin project folder (defaults to CWD) |
Examples
wiqd plugin add connector --name "Contoso Tools" --description "MCP toolbelt" --url https://tools.contoso.com/mcpwiqd plugin add connector --kind openapi --name "Contoso Kusto" --description "Existing custom connector" --auth-reference-id shared_kusto --dev-previewwiqd plugin add connector --kind openapi --name "Contoso Kusto" --description "Existing custom connector" --auth-reference-id shared_kusto --dev-preview --jsonwiqd plugin add environment
Section titled “wiqd plugin add environment”Copy an existing plugin environment to a new name.
Extension: wiqd Core
wiqd plugin add environment [options]Options
| Option | Description |
|---|---|
--name <value> | New environment name |
--from <value> | Source environment (default: “local”) |
-f, --folder <value> | Plugin project folder (defaults to CWD) |
Examples
wiqd plugin add environment --name <value>wiqd plugin add environment --name <value> --from <value> --folder <value>wiqd plugin add environment --name <value> --jsonwiqd plugin add market-listing
Section titled “wiqd plugin add market-listing”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
wiqd plugin add market-listing [options]Options
| Option | Description |
|---|---|
--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
wiqd plugin add market-listing --agent-folder <value> --categories <value> --industries <value> --requires-associated-service-purchase truewiqd 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 --jsonwiqd plugin add skill
Section titled “wiqd plugin add skill”Scaffold a SKILL.md skill folder and register it in the plugin manifest.
Extension: wiqd Core
wiqd plugin add skill [options]Options
| Option | Description |
|---|---|
-n, --name <value> | Skill display name |
-f, --folder <value> | Plugin project folder (defaults to CWD) |
Examples
wiqd plugin add skill --name <value>wiqd plugin add skill --name <value> --folder <value>wiqd plugin add skill --name <value> --jsonwiqd plugin ask
Section titled “wiqd plugin ask”Send a message directly to a declarative agent component.
Extension: Work IQ
wiqd plugin ask [options]Options
| Option | Description |
|---|---|
--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 |
--devui | Proxy 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. |
--developer | Include Work IQ developer execution metadata; may contain sensitive diagnostics |
Examples
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> --jsonwiqd plugin create
Section titled “wiqd plugin create”Scaffold a new, empty standalone plugin project from the built-in blank app template.
Extension: wiqd Core
wiqd plugin create [options]Options
| Option | Description |
|---|---|
-n, --name <value> | Plugin project name |
-o, --output <value> | Output directory (defaults to CWD) |
--force | Re-scaffold over a non-empty destination, discarding what is there now |
Examples
wiqd plugin create --name <value>wiqd plugin create --name <value> --output <value> --forcewiqd plugin create --name <value> --jsonwiqd plugin delete
Section titled “wiqd plugin delete”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
wiqd plugin delete [options]Options
| Option | Description |
|---|---|
-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-file | Keep the local env file after deletion (project mode only) |
--yes | Skip confirmation prompt |
Examples
wiqd plugin deletewiqd plugin delete --env <value> --path <value>wiqd plugin delete --jsonwiqd plugin export
Section titled “wiqd plugin export”Export a plugin project to Open Plugin (or Claude/Cursor) format.
Extension: wiqd Core
wiqd plugin export [options]Options
| Option | Description |
|---|---|
-p, --path <value> | Plugin project path (defaults to CWD) |
-o, --output <value> | Output Open Plugin directory (defaults to |
--format <value> | Export format (choices: “open-plugin”, “claude-plugin”, “cursor-plugin”, default: “open-plugin”) |
Examples
wiqd plugin exportwiqd plugin export --path <value> --output <value>wiqd plugin export --jsonwiqd plugin get
Section titled “wiqd plugin get”Get plugin resources.
Extension: Validation & LSP
wiqd plugin get <command>Examples
wiqd plugin getwiqd plugin get market-listingwiqd plugin get --helpwiqd plugin get market-listing
Section titled “wiqd plugin get market-listing”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
wiqd plugin get market-listing [options]Options
| Option | Description |
|---|---|
--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
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> --jsonwiqd plugin import
Section titled “wiqd plugin import”Import an Open Plugin (or Claude/Cursor plugin) as a new plugin project.
Extension: wiqd Core
wiqd plugin import [options]Options
| Option | Description |
|---|---|
-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
wiqd plugin import --path <value>wiqd plugin import --path <value> --output <value> --privacy-url <value>wiqd plugin import --path <value> --jsonwiqd plugin list
Section titled “wiqd plugin list”List standalone plugin projects under a directory.
Extension: wiqd Core
wiqd plugin list [options] <command>Options
| Option | Description |
|---|---|
-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
wiqd plugin listwiqd plugin list --name <value> --top <value>wiqd plugin list --helpwiqd plugin list collaborators
Section titled “wiqd plugin list collaborators”List verified co-owners for the selected M365 plugin title, including standalone plugins.
Extension: wiqd Core
wiqd plugin list collaborators [options]Options
| Option | Description |
|---|---|
--env <value> | Target environment (default: “local”) |
--path <value> | Plugin project path (defaults to CWD) |
Examples
wiqd plugin list collaboratorswiqd plugin list collaborators --env <value> --path <value>wiqd plugin list collaborators --jsonwiqd plugin list environments
Section titled “wiqd plugin list environments”List environments from the lifecycle-configured environment folder.
Extension: wiqd Core
wiqd plugin list environments [options]Options
| Option | Description |
|---|---|
-f, --folder <value> | Plugin project folder (defaults to CWD) |
Examples
wiqd plugin list environmentswiqd plugin list environments --folder <value>wiqd plugin list environments --jsonwiqd plugin list templates
Section titled “wiqd plugin list templates”List supported templates for ‘wiqd plugin add agent’.
Extension: wiqd Core
wiqd plugin list templatesExamples
wiqd plugin list templateswiqd plugin list templates --jsonwiqd plugin package
Section titled “wiqd plugin package”Package the plugin into a .zip. Use —offline for a local-only preview connector/skill package without provisioning or server validation.
Extension: wiqd Core
wiqd plugin package [options]Options
| Option | Description |
|---|---|
--offline | Build 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
wiqd plugin packagewiqd plugin package --env <value> --output <value>wiqd plugin package --jsonwiqd plugin preview
Section titled “wiqd plugin preview”Preview plugin resources.
Extension: Validation & LSP
wiqd plugin preview <command>Examples
wiqd plugin previewwiqd plugin preview market-listingwiqd plugin preview --helpwiqd plugin preview market-listing
Section titled “wiqd plugin preview market-listing”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
wiqd plugin preview market-listing [options]Options
| Option | Description |
|---|---|
--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
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> --jsonwiqd plugin provision
Section titled “wiqd plugin provision”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
wiqd plugin provision [options] <command>Options
| Option | Description |
|---|---|
-e, --env <value> | Target environment (default: “local”) |
--path <value> | Plugin project path (defaults to CWD) |
Examples
wiqd plugin provisionwiqd plugin provision --env <value> --path <value>wiqd plugin provision --helpwiqd plugin provision package
Section titled “wiqd plugin provision package”Prepare or personally sideload a final DA or supported MCP connector ZIP without a source project.
Extension: wiqd Core
wiqd plugin provision package [options]Options
| Option | Description |
|---|---|
--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-run | Prepare locally without authentication or installation |
--reconcile | Read 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
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> --jsonwiqd plugin publish
Section titled “wiqd plugin publish”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
wiqd plugin publish [options]Options
| Option | Description |
|---|---|
--env <value> | Environment to publish (default: “local”) |
--path <value> | Plugin project path (defaults to CWD) |
--manifest <value> | Contained app manifest file override |
--dry-run | Run the validation pipeline and report readiness without submitting (default: false) |
--no-runtime | Skip Phase 3 (agent response sampling) and Phase 4 (browser) in dry-run mode |
--no-network | Skip Phase 2 (URL reachability) in dry-run mode |
--browser | Opt 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
wiqd plugin publishwiqd plugin publish --env <value> --path <value>wiqd plugin publish --jsonwiqd plugin remove
Section titled “wiqd plugin remove”Remove plugin access.
Extension: wiqd Core
wiqd plugin remove <command>Examples
wiqd plugin removewiqd plugin remove accesswiqd plugin remove --helpwiqd plugin remove access
Section titled “wiqd plugin remove access”Remove plugin usage or existing shared-access grants. This is not title co-owner removal.
Extension: wiqd Core
wiqd plugin remove access [options]Options
| Option | Description |
|---|---|
--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
wiqd plugin remove accesswiqd plugin remove access --users <value> --owners <value>wiqd plugin remove access --jsonwiqd plugin repair
Section titled “wiqd plugin repair”Repair plugin artifacts.
Extension: Validation & LSP
wiqd plugin repair <command>Examples
wiqd plugin repairwiqd plugin repair packagewiqd plugin repair --helpwiqd plugin repair package
Section titled “wiqd plugin repair package”Apply explicit hash-bound replacements to a new ZIP without a source project. Preserves the original; does not validate or publish.
Extension: Validation & LSP
wiqd plugin repair package [options]Options
| Option | Description |
|---|---|
--package-file <value> | Original final ZIP |
--changes-file <value> | JSON with packageSha256 and replacements [{path,contentPath}] |
--output <value> | Previously absent output ZIP path |
Examples
wiqd plugin repair package --package-file <value> --changes-file <value> --output <value>wiqd plugin repair package --package-file <value> --changes-file <value> --output <value> --jsonwiqd plugin reset
Section titled “wiqd plugin reset”Reset plugin state.
Extension: wiqd Core
wiqd plugin reset <command>Examples
wiqd plugin resetwiqd plugin reset environmentwiqd plugin reset --helpwiqd plugin reset environment
Section titled “wiqd plugin reset environment”Reset a plugin environment and its optional .user sidecar.
Extension: wiqd Core
wiqd plugin reset environment [options]Options
| Option | Description |
|---|---|
--env <value> | Environment to reset |
-f, --folder <value> | Plugin project folder (defaults to CWD) |
Examples
wiqd plugin reset environment --env <value>wiqd plugin reset environment --env <value> --folder <value>wiqd plugin reset environment --env <value> --jsonwiqd plugin share
Section titled “wiqd plugin share”Share a plugin with users or the entire tenant. Requires Microsoft 365 sign-in; use wiqd auth login --interactive.
Extension: wiqd Core
wiqd plugin share [options]Options
| Option | Description |
|---|---|
--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
wiqd plugin sharewiqd plugin share --scope users --email <value>wiqd plugin share --jsonwiqd plugin show
Section titled “wiqd plugin show”Show complete offline details for a local plugin and its optional embedded agent.
Extension: wiqd Core
wiqd plugin show [options]Options
| Option | Description |
|---|---|
--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
wiqd plugin showwiqd plugin show --path <value> --name <value>wiqd plugin show --jsonwiqd plugin validate
Section titled “wiqd plugin validate”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
wiqd plugin validate [options]Options
| Option | Description |
|---|---|
--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-batch | Collect independent conversational questions in one shared structured request; requires —agent-id and marketplace, with no retry or fallback |
--functional-batch-allow-duplicate-json | Allow 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-telemetry | Telemetry-only marker for authorized Auto Fix revalidation; does not apply repairs |
Examples
wiqd plugin validatewiqd plugin validate --mode <value> --path <value>wiqd plugin validate --jsonwiqd policy
Section titled “wiqd policy”Work IQ maker-policy operations
Extension: wiqd (core)
wiqd policy <command>Examples
wiqd policywiqd policy publishwiqd policy --helpwiqd policy publish
Section titled “wiqd policy publish”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
wiqd policy publish [options]Options
| Option | Description |
|---|---|
--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
wiqd policy publish --title-id <value> --file <value> --caller-id <value>wiqd policy publish --title-id <value> --file <value> --caller-id <value> --jsonwiqd publish
Section titled “wiqd publish”Publish prepared packages to a registry or marketplace
Extension: wiqd (core)
wiqd publish <command>Examples
wiqd publishwiqd publish pcwiqd publish --helpwiqd publish pc
Section titled “wiqd publish pc”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
wiqd publish pc [options] <command>Options
| Option | Description |
|---|---|
--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-only | Assert a listing-only change; still cross-checked by the real preflight. |
--interactive | Requests typed submission authorization at a real terminal after Draft verification. Choose this or —authorize-submit, not both. |
--authorize-submit | Explicitly 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
wiqd publish pcwiqd publish pc --path <value> --listing <value>wiqd publish pc --helpwiqd publish pc access
Section titled “wiqd publish pc access”Show static Marketplace publisher setup guidance; WIQD cannot verify publishing readiness at this time.
Extension: Partner Center Publishing Foundation
wiqd publish pc accessExamples
wiqd publish pc accesswiqd publish pc access --jsonwiqd publish pc init
Section titled “wiqd publish pc init”Scaffold or read partner-center.json for this project; optionally verifies —product-id against the real Product.
Extension: Partner Center Publishing Foundation
wiqd publish pc init [options]Options
| Option | Description |
|---|---|
--path <value> | Project context (default .). |
--listing <value> | Destination partner-center.json path (default partner-center.json); scaffolded if absent. |
--product-id <value> | Canonical product/ |
Examples
wiqd publish pc initwiqd publish pc init --path <value> --listing <value>wiqd publish pc init --jsonwiqd publish pc preflight
Section titled “wiqd publish pc preflight”Read the real Product/resource-tree and classify the proposed change (listing-only vs. package/version impact).
Extension: Partner Center Publishing Foundation
wiqd publish pc preflight [options]Options
| Option | Description |
|---|---|
--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-only | Assert a listing-only change; still cross-checked against the real classification. |
Examples
wiqd publish pc preflightwiqd publish pc preflight --path <value> --listing <value>wiqd publish pc preflight --jsonwiqd publish pc prepare
Section titled “wiqd publish pc prepare”Create/update the real Draft: configure listing fields, upload package/assets via MCP, and record the Product ID locally.
Extension: Partner Center Publishing Foundation
wiqd publish pc prepare [options]Options
| Option | Description |
|---|---|
--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-only | Assert a listing-only change; still cross-checked against the real classification. |
--interactive | Guided shape only; no prompts. |
--yes | Required for Draft updates. Does not authorize submission. |
Examples
wiqd publish pc preparewiqd publish pc prepare --path <value> --listing <value>wiqd publish pc prepare --jsonwiqd publish pc resume
Section titled “wiqd publish pc resume”Show a synthetic resume result; no operation is read, reconciled, or continued.
Extension: Partner Center Publishing Foundation
wiqd publish pc resume [options]Options
| Option | Description |
|---|---|
--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. |
--interactive | Guided shape only; no prompts or consent. |
Examples
wiqd publish pc resume --operation <value>wiqd publish pc resume --operation <value> --path <value> --listing <value>wiqd publish pc resume --operation <value> --jsonwiqd publish pc status
Section titled “wiqd publish pc status”Read real job/submission/resource-tree state for the selected Product or configure job.
Extension: Partner Center Publishing Foundation
wiqd publish pc status [options]Options
| Option | Description |
|---|---|
--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/ |
--job-id <value> | Configure job ID to read status for. |
--watch | Poll until a terminal state is reached instead of a single read. |
Examples
wiqd publish pc statuswiqd publish pc status --path <value> --listing <value>wiqd publish pc status --jsonwiqd publish pc submit
Section titled “wiqd publish pc submit”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
wiqd publish pc submit [options]Options
| Option | Description |
|---|---|
--path <value> | Project context (default .). |
--listing <value> | Listing file read for the prepared Product ID (default partner-center.json). |
--product-id <value> | Canonical product/pc prepare. |
--yes | Required 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. |
--interactive | In addition to —yes, requests an explicit “submit” confirmation at a real terminal after Draft verification. Choose this or —authorize-submit, not both. |
--authorize-submit | In 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
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> --jsonwiqd publish pc update
Section titled “wiqd publish pc update”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
wiqd publish pc update [options]Options
| Option | Description |
|---|---|
--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-package | Rebuild 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-only | States that only listing content changed. The package version is still bumped and the package rebuilt. |
--dry-run | Read the offer and show what an update would do, including the proposed package version. Writes nothing. |
--logo | Update only the listing logo selected by assets.logo in partner-center.json; app-package icons are not edited. |
--screenshots | Upload 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. |
--yes | Apply explicitly selected fields/media and the required package to Draft. Never submits. |
--submit | Also submit the updated Draft for certification. Requires —yes and —interactive. Not supported yet. |
--interactive | Ask add versus replace for screenshots in a real terminal when —screenshot-mode is omitted. Never authorizes submission. |
Examples
wiqd publish pc updatewiqd publish pc update --path <value> --listing <value>wiqd publish pc update --jsonwiqd update
Section titled “wiqd update”Update wiqd to the latest version
Extension: wiqd (core)
wiqd update [options]Options
| Option | Description |
|---|---|
--version <version> | Install specific version |
--check | Check for updates without installing |
--channel <channel> | Release channel: latest, preview, dev (npm alpha) |
--force | Deprecated: update always reinstalls; kept for compatibility |
--dry-run | Show what would be done without doing it |
--skip-extension | Skip VS Code extension update |
--skip-plugin | Skip installer-owned plugin updates |
Examples
wiqd updatewiqd update --version <version> --channel <channel>wiqd update --jsonUpdate outcomes
Section titled “Update outcomes”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
Section titled “Feature flags”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.
| Flag | Type | Default | Stage | Owner | Since | Description |
|---|---|---|---|---|---|---|
frontier | boolean | false | alpha | wiqd-core | 0.14.0 | Enables preview capabilities across wiqd and participating extensions. |
agent-skills | boolean | false | beta | microsoft.wiqd.core | 0.12.2 | Enables 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. |
devui | boolean | false | beta | microsoft.devui | 0.5.0 | Enables the wiqd devui commands (the local Work IQ DevUI web experience). Opt-in while the experience is in preview. |
partner-center-publishing | boolean | true | alpha | microsoft.marketplace | 0.17.0 | Expose 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-monitor | boolean | true | beta | microsoft.workiq | 0.2.2 | Enables 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>:
| Flag | Env var |
|---|---|
frontier | WIQD_FLAG_FRONTIER |
agent-skills | WIQD_FLAG_AGENT_SKILLS |
devui | WIQD_FLAG_DEVUI |
partner-center-publishing | WIQD_FLAG_PARTNER_CENTER_PUBLISHING |
workiq-monitor | WIQD_FLAG_WORKIQ_MONITOR |