Command reference

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.

Note

Commands contributed by extensions you add yourself (wiqd ext add) and hidden or experimental commands are not listed here; run wiqd --help (or wiqd <command> --help) to see the exact surface in your environment. The examples show command syntax, not guaranteed-valid argument combinations — some commands have requirements (such as mutually exclusive options) that are described in each command’s options table.

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.

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”, default: “warning”)
-h, --help	display help for command

Command index

wiqd config

Command	Extension	Description
wiqd config	wiqd (core)	Manage wiqd configuration settings
wiqd config set	wiqd (core)	Set configuration values
wiqd config reset	wiqd (core)	Reset all configuration to defaults
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 show	wiqd (core)	Show definition and resolved value for a single feature flag
wiqd config flags set	wiqd (core)	Persist a feature flag value
wiqd config flags reset	wiqd (core)	Clear a persisted feature flag value

wiqd auth

Command	Extension	Description
wiqd auth	wiqd (core)	Manage authentication for wiqd and its extensions
wiqd auth login	wiqd (core)	Sign in to wiqd services
wiqd auth logout	wiqd (core)	Sign out of wiqd services
wiqd auth status	wiqd (core)	Show authentication status

wiqd update

Command	Extension	Description
wiqd update	wiqd (core)	Update wiqd to the latest version

wiqd changelog

Command	Extension	Description
wiqd changelog	wiqd (core)	Show wiqd release changelog

wiqd component

Command	Extension	Description
wiqd component	wiqd (core)	Manage wiqd host integrations (Copilot/Claude plugin, VS Code extension)
wiqd component plugin	wiqd (core)	Manage the wiqd plugin for Copilot CLI or Claude Code
wiqd component plugin install	wiqd (core)	Install the wiqd plugin into Copilot CLI or Claude Code
wiqd component plugin uninstall	wiqd (core)	Uninstall the wiqd plugin from Copilot CLI or Claude Code
wiqd component plugin info	wiqd (core)	Report where the wiqd plugin is installed for the selected CLI
wiqd component vscode	wiqd (core)	Manage the Work IQ VS Code extension
wiqd component vscode install	wiqd (core)	Install the VS Code extension
wiqd component vscode uninstall	wiqd (core)	Uninstall the VS Code extension
wiqd component vscode info	wiqd (core)	Report the VS Code extension install location (stable + insiders)

wiqd doctor

Command	Extension	Description
wiqd doctor	wiqd (core)	Check environment health (Node.js, extensions, auth)

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 eula

Command	Extension	Description
wiqd eula	wiqd (core)	Accept or report downstream-tool End User License Agreements (EULAs)
wiqd eula status	wiqd (core)	Report EULA-acceptance state for all EULA-gated tools
wiqd eula accept	wiqd (core)	Accept one tool’s EULA through the human-confirmed acceptance path

wiqd ext

Command	Extension	Description
wiqd ext	wiqd (core)	Manage installed wiqd extensions
wiqd ext list	wiqd (core)	List discovered and registered extensions
wiqd ext show	wiqd (core)	Show extension details
wiqd ext add	wiqd (core)	Activate an installed extension (registers it in ~/.wiqd/extensions.json)
wiqd ext remove	wiqd (core)	Deactivate an extension (removes it from ~/.wiqd/extensions.json)

wiqd completion

Command	Extension	Description
wiqd completion	wiqd (core)	Output a shell tab-completion script (bash, zsh, powershell, fish)

wiqd agent

Command	Extension	Description
wiqd agent	wiqd (core)	Build, validate, provision, publish, and monitor declarative agents
wiqd agent show	wiqd (core)	Show a local summary of the agent project (manifest, capabilities, environments).
wiqd agent create	Agents Toolkit	Scaffold a new declarative agent project.
wiqd agent create list	Agents Toolkit	List available declarative agent templates.
wiqd agent add	Agents Toolkit	Augment an existing declarative agent with an action, skill, or auth config.
wiqd agent add action	Agents Toolkit	Add an OpenAPI-spec action to a declarative agent.
wiqd agent add skill	Agents Toolkit	Add a skill to a declarative agent.
wiqd agent add auth	Agents Toolkit	Add an auth configuration to a plugin manifest.
wiqd agent provision	Agents Toolkit	Provision a declarative agent to an environment. Requires ATK sign-in; use wiqd auth login --interactive.
wiqd agent package	Agents Toolkit	Package the agent into a deployable .zip.
wiqd agent share	Agents Toolkit	Share an agent with specific users, a mail-enabled security group, or the entire tenant. Requires ATK sign-in; use wiqd auth login --interactive.
wiqd agent share remove	Agents Toolkit	Remove user or owner access from an agent. Requires ATK sign-in; use wiqd auth login --interactive.
wiqd agent share collaborator	Agents Toolkit	collaborator
wiqd agent share collaborator add	Agents Toolkit	Grant a user collaborator access (Entra app + TDP agent). Requires ATK sign-in; use wiqd auth login --interactive.
wiqd agent share collaborator list	Agents Toolkit	List the agent’s collaborators. Requires ATK sign-in; use wiqd auth login --interactive.
wiqd agent env	Agents Toolkit	env
wiqd agent env list	Agents Toolkit	List the project’s environments.
wiqd agent env add	Agents Toolkit	Add a new environment, copying from an existing one.
wiqd agent env reset	Agents Toolkit	Reset (clear) an existing environment file.
wiqd agent info	Agents Toolkit	Show MOS3 launch / acquisition info for a deployed agent (proxies atk launchinfo). Accepts —agent-id (e.g. P_xxx.declarativeAgent), —title-id, or —manifest-id; emits the raw launchinfo JSON. Used by the DevUI portal. Requires ATK sign-in; use wiqd auth login --interactive.
wiqd agent delete	Agents Toolkit	Delete an agent’s cloud resources. Either by env (project-based) or by —title-id (works for any agent you can administer, no local project required). Requires ATK sign-in; use wiqd auth login --interactive.
wiqd agent publish	Agents Toolkit	Publish an agent to the org catalog. Requires ATK sign-in; use wiqd auth login --interactive.
wiqd agent validate	Manifest Validation & LSP	Validate agent manifests (static or deep).
wiqd agent monitor	Work IQ	Query the Insights Agent about a provisioned agent’s performance and usage.
wiqd agent ask	Work IQ	Send a message directly to a declarative agent.
wiqd agent list	Work IQ	List declarative agents deployed in the tenant.
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 starter suite tailored to the default declarative-agent template, plus env/.env..user from your Azure OpenAI / tenant env vars).

wiqd plugin

Command	Extension	Description
wiqd plugin	wiqd (core)	Build, validate, package, and publish standalone plugins (agent + skills + connector)
wiqd plugin add	Agents Toolkit	add
wiqd plugin add agent	Agents Toolkit	Add a declarative agent component to a plugin.
wiqd plugin add skill	Agents Toolkit	Scaffold a SKILL.md skill folder and register it in the plugin manifest.
wiqd plugin add connector	Agents Toolkit	Add a remote MCP agent connector to the plugin manifest.
wiqd plugin show	Agents Toolkit	Show a summary of a standalone plugin project.
wiqd plugin list	Agents Toolkit	List standalone plugin projects under a directory.
wiqd plugin provision	Agents Toolkit	Provision a plugin to an environment. Requires ATK sign-in; use wiqd auth login --interactive.
wiqd plugin package	Agents Toolkit	Package the plugin into a deployable .zip.
wiqd plugin share	Agents Toolkit	Share a plugin with users or the entire tenant. Requires ATK sign-in; use wiqd auth login --interactive.
wiqd plugin delete	Agents Toolkit	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 ATK sign-in; use wiqd auth login --interactive.
wiqd plugin create	Agents Toolkit	Scaffold a new, empty standalone plugin project from ATK’s blank app template.
wiqd plugin import	Agents Toolkit	Import an Open Plugin (or Claude/Cursor plugin) as a new plugin project.
wiqd plugin export	Agents Toolkit	Export a plugin project to Open Plugin (or Claude/Cursor) format.
wiqd plugin validate	Manifest Validation & LSP	Validate a standalone plugin project (static MVL; —mode deep validates the built package via ATK).

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 devui

Command	Extension	Description
wiqd devui	wiqd (core)	Launch the local Work IQ DevUI web experience
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 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 config

Manage wiqd configuration settings

Extension: wiqd (core)

wiqd config <command>

Examples

wiqd config
wiqd config set
wiqd config reset
wiqd config flags
wiqd config --help

wiqd config set

Set configuration values

Extension: wiqd (core)

wiqd config set pairs

Arguments

Argument	Description
pairs	Key=value pairs to set

Examples

wiqd config set
wiqd config set [pairs...]

wiqd config reset

Reset all configuration to defaults

Extension: wiqd (core)

wiqd config reset

Examples

wiqd config reset
wiqd config reset --json

wiqd config flags

Manage wiqd feature flags

Extension: wiqd (core)

wiqd config flags <command>

Examples

wiqd config flags
wiqd config flags list
wiqd config flags --help

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 list
wiqd config flags list --enabled-only
wiqd config flags list --json

wiqd config flags show

Show definition and resolved value for a single feature flag

Extension: wiqd (core)

wiqd config flags show name

Arguments

Argument	Description
name	Flag name (e.g. my-flag)

Examples

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

wiqd config flags set

Persist a feature flag value

Extension: wiqd (core)

wiqd config flags set name value

Arguments

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> --json

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 reset
wiqd config flags reset --all
wiqd config flags reset [name]

wiqd auth

Manage authentication for wiqd and its extensions

Extension: wiqd (core)

wiqd auth <command>

Examples

wiqd auth
wiqd auth login
wiqd auth logout
wiqd auth status
wiqd auth --help

wiqd auth login

Sign in to wiqd services

Extension: wiqd (core)

wiqd auth login [options]

Options

Option	Description
--interactive	Force interactive login

Examples

wiqd auth login
wiqd auth login --interactive
wiqd auth login --json

wiqd auth logout

Sign out of wiqd services

Extension: wiqd (core)

wiqd auth logout

Examples

wiqd auth logout
wiqd auth logout --json

wiqd auth status

Show authentication status

Extension: wiqd (core)

wiqd auth status

Examples

wiqd auth status
wiqd auth status --json

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>	npm dist-tag channel
--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 Copilot CLI plugin refresh

Examples

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

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 release
wiqd changelog --version <version>      # one specific release
wiqd changelog --from <version>         # everything AFTER that release

wiqd component

Manage wiqd host integrations (Copilot/Claude plugin, VS Code extension)

Extension: wiqd (core)

wiqd component <command>

Examples

wiqd component
wiqd component plugin
wiqd component vscode
wiqd component --help

wiqd component plugin

Manage the wiqd plugin for Copilot CLI or Claude Code

Extension: wiqd (core)

wiqd component plugin <command>

Examples

wiqd component plugin
wiqd component plugin install
wiqd component plugin uninstall
wiqd component plugin info
wiqd component plugin --help

wiqd component plugin install

Install the wiqd plugin into Copilot CLI or Claude Code

Extension: wiqd (core)

wiqd component plugin install [options]

Options

Option	Description
--cli <cli>	Which CLI to target (choices: “copilot”, “claude”, default: “copilot”)
--force	Uninstall and re-install even if already present

Examples

wiqd component plugin install
wiqd component plugin install --cli copilot --force
wiqd component plugin install --json

wiqd component plugin uninstall

Uninstall the wiqd plugin from Copilot CLI or Claude Code

Extension: wiqd (core)

wiqd component plugin uninstall [options]

Options

Option	Description
--cli <cli>	Which CLI to target (choices: “copilot”, “claude”, default: “copilot”)

Examples

wiqd component plugin uninstall
wiqd component plugin uninstall --cli copilot
wiqd component plugin uninstall --json

wiqd component plugin info

Report where the wiqd plugin is installed for the selected CLI

Extension: wiqd (core)

wiqd component plugin info [options]

Options

Option	Description
--cli <cli>	Which CLI to target (choices: “copilot”, “claude”, default: “copilot”)

Examples

wiqd component plugin info
wiqd component plugin info --cli copilot
wiqd component plugin info --json

wiqd component vscode

Manage the Work IQ VS Code extension

Extension: wiqd (core)

wiqd component vscode <command>

Examples

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

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 install
wiqd component vscode install --insiders --force
wiqd component vscode install --json

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 uninstall
wiqd component vscode uninstall --insiders
wiqd component vscode uninstall --json

wiqd component vscode info

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

Extension: wiqd (core)

wiqd component vscode info

Examples

wiqd component vscode info
wiqd component vscode info --json

wiqd doctor

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

Extension: wiqd (core)

wiqd doctor

Examples

wiqd doctor
wiqd doctor --json

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 args

Arguments

Argument	Description
cli	Name of the managed CLI to run (e.g. workiq)
args	Arguments forwarded to the CLI unchanged

Examples

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

wiqd eula

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

Extension: wiqd (core)

wiqd eula <command>

Examples

wiqd eula
wiqd eula status
wiqd eula accept
wiqd eula --help

wiqd eula status

Report EULA-acceptance state for all EULA-gated tools

Extension: wiqd (core)

wiqd eula status

Examples

wiqd eula status
wiqd eula status --json

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
--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>
wiqd eula accept <tool> --json

wiqd ext

Manage installed wiqd extensions

Extension: wiqd (core)

wiqd ext <command>

Examples

wiqd ext
wiqd ext list
wiqd ext --help

wiqd ext list

List discovered and registered extensions

Extension: wiqd (core)

wiqd ext list

Examples

wiqd ext list
wiqd ext list --json

wiqd ext show

Show extension details

Extension: wiqd (core)

wiqd ext show id

Arguments

Argument	Description
id	Extension ID

Examples

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

wiqd ext add

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

Extension: wiqd (core)

wiqd ext add id

Arguments

Argument	Description
id	Extension manifest ID or npm package name

Examples

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

wiqd ext remove

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

Extension: wiqd (core)

wiqd ext remove id

Arguments

Argument	Description
id	Extension manifest ID or npm package name

Examples

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

wiqd completion

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

Extension: wiqd (core)

wiqd completion shell

Arguments

Argument	Description
shell	Target shell: bash, zsh, powershell, or fish

Examples

wiqd completion <shell>
wiqd completion <shell> --json

wiqd agent

Build, validate, provision, publish, and monitor declarative agents

Extension: wiqd (core)

wiqd agent <command>

Examples

wiqd agent
wiqd agent show
wiqd agent --help

wiqd agent show

Show a local summary of the agent project (manifest, capabilities, environments).

Extension: wiqd (core)

wiqd agent show [options]

Options

Option	Description
--path <path>	Agent project directory
--env <env>	Target environment (default: “local”)
--name <name>	Agent name filter
--id <id>	Agent ID filter
--verbose	Show verbose output

Examples

wiqd agent show
wiqd agent show --path <path> --env <env>
wiqd agent show --json

wiqd agent create

Scaffold a new declarative agent project.

Extension: Agents Toolkit

wiqd agent create [options] <command>

Options

Option	Description
-t, --template <value>	Agent template (default: declarative-agent — the only family wiqd supports) (default: “declarative-agent”)
-n, --name <value>	Project name
-o, --output <value>	Output directory

Examples

wiqd agent create
wiqd agent create --template <value> --name <value>
wiqd agent create --help

wiqd agent create list

List available declarative agent templates.

Extension: Agents Toolkit

wiqd agent create list

Examples

wiqd agent create list
wiqd agent create list --json

wiqd agent add

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

Extension: Agents Toolkit

wiqd agent add <command>

Examples

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

wiqd agent add action

Add an OpenAPI-spec action to a declarative agent.

Extension: Agents Toolkit

wiqd agent add action [options]

Options

Option	Description
--openapi-spec <value>	OpenAPI spec path or URL
--operations <value>	OpenAPI operation selectors as METHOD /path (comma-separated)
-f, --folder <value>	Project folder

Examples

wiqd agent add action
wiqd agent add action --openapi-spec <value> --operations <value>
wiqd agent add action --json

wiqd agent add skill

Add a skill to a declarative agent.

Extension: Agents Toolkit

wiqd agent add skill [options]

Options

Option	Description
--name <value>	Skill name (required unless —from is used)
--description <value>	Skill description
--from <value>	Import from existing skill directory or .zip
--expose-to-copilot	Expose to mainline M365 Copilot (default: false)
-f, --folder <value>	Project folder

Examples

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

wiqd agent add auth

Add an auth configuration to a plugin manifest.

Extension: Agents Toolkit

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>	Auth type
--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)
--authorization-url <value>	OAuth authorization URL
--token-url <value>	OAuth token URL
--scope <value>	OAuth scope
-f, --folder <value>	Project folder

Examples

wiqd agent add auth
wiqd agent add auth --plugin-manifest <value> --auth-name <value>
wiqd agent add auth --json

wiqd agent provision

Provision a declarative agent to an environment. Requires ATK sign-in; use wiqd auth login --interactive.

Extension: Agents Toolkit

wiqd agent provision [options]

Options

Option	Description
-e, --env <value>	Target environment (default: “local”)
--path <value>	Project path (defaults to CWD)

Examples

wiqd agent provision
wiqd agent provision --env <value> --path <value>
wiqd agent provision --json

wiqd agent package

Package the agent into a deployable .zip.

Extension: Agents Toolkit

wiqd agent package [options]

Options

Option	Description
--env <value>	Environment to resolve variables from (default: “local”)
--output <value>	Output path for the zip package
--path <value>	Project path (defaults to CWD)

Examples

wiqd agent package
wiqd agent package --env <value> --output <value>
wiqd agent package --json

wiqd agent share

Share an agent with specific users, a mail-enabled security group, or the entire tenant. Requires ATK sign-in; use wiqd auth login --interactive.

Extension: Agents Toolkit

wiqd agent share [options] <command>

Options

Option	Description
--scope <value>	Share scope: ‘users’ or ‘tenant’ (default: “users”)
--email <value>	Comma-separated email addresses of individual users and/or a mail-enabled security group’s address
--env <value>	Target environment (default: “local”)
--path <value>	Project path

Examples

wiqd agent share
wiqd agent share --scope <value> --email <value>
wiqd agent share --help

wiqd agent share remove

Remove user or owner access from an agent. Requires ATK sign-in; use wiqd auth login --interactive.

Extension: Agents Toolkit

wiqd agent share remove [options]

Options

Option	Description
--users <value>	Comma-separated emails to revoke user access
--owners <value>	Comma-separated emails to revoke owner access
--env <value>	(default: “local”)
--path <value>

Examples

wiqd agent share remove
wiqd agent share remove --users <value> --owners <value>
wiqd agent share remove --json

wiqd agent share collaborator

collaborator

Extension: Agents Toolkit

wiqd agent share collaborator <command>

Examples

wiqd agent share collaborator
wiqd agent share collaborator add
wiqd agent share collaborator list
wiqd agent share collaborator --help

wiqd agent share collaborator add

Grant a user collaborator access (Entra app + TDP agent). Requires ATK sign-in; use wiqd auth login --interactive.

Extension: Agents Toolkit

wiqd agent share collaborator add [options]

Options

Option	Description
--email <value>	Collaborator email
--env <value>	(default: “local”)
--path <value>

Examples

wiqd agent share collaborator add
wiqd agent share collaborator add --email <value> --env <value>
wiqd agent share collaborator add --json

wiqd agent share collaborator list

List the agent’s collaborators. Requires ATK sign-in; use wiqd auth login --interactive.

Extension: Agents Toolkit

wiqd agent share collaborator list [options]

Options

Option	Description
--all	Show all collaborators
--env <value>	(default: “local”)
--path <value>

Examples

wiqd agent share collaborator list
wiqd agent share collaborator list --env <value> --path <value>
wiqd agent share collaborator list --json

wiqd agent env

env

Extension: Agents Toolkit

wiqd agent env <command>

Examples

wiqd agent env
wiqd agent env list
wiqd agent env add
wiqd agent env reset
wiqd agent env --help

wiqd agent env list

List the project’s environments.

Extension: Agents Toolkit

wiqd agent env list [options]

Options

Option	Description
-f, --folder <value>	Project folder

Examples

wiqd agent env list
wiqd agent env list --folder <value>
wiqd agent env list --json

wiqd agent env add

Add a new environment, copying from an existing one.

Extension: Agents Toolkit

wiqd agent env add [options]

Options

Option	Description
--name <value>	New environment name
--from <value>	Source environment to copy from (default: “local”)
-f, --folder <value>	Project folder

Examples

wiqd agent env add
wiqd agent env add --name <value> --from <value>
wiqd agent env add --json

wiqd agent env reset

Reset (clear) an existing environment file.

Extension: Agents Toolkit

wiqd agent env reset [options]

Options

Option	Description
--env <value>	Environment to reset
-f, --folder <value>	Project folder

Examples

wiqd agent env reset
wiqd agent env reset --env <value> --folder <value>
wiqd agent env reset --json

wiqd agent info

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

Extension: Agents Toolkit

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 info
wiqd agent info --agent-id <value> --title-id <value>
wiqd agent info --json

wiqd agent delete

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

Extension: Agents Toolkit

Aliases: uninstall

wiqd agent delete [options]

Options

Option	Description
--env <value>	Environment to delete (ignored when —title-id is set) (default: “local”)
--path <value>	Project path (ignored when —title-id is set)
--title-id <value>	Title ID of the agent 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 agent delete
wiqd agent delete --env <value> --path <value>
wiqd agent delete --json

wiqd agent publish

Publish an agent to the org catalog. Requires ATK sign-in; use wiqd auth login --interactive.

Extension: Agents Toolkit

wiqd agent publish [options]

Options

Option	Description
--env <value>	Environment to publish (default: “local”)
--path <value>	Project path
--manifest <value>	Manifest file path
--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 agent publish
wiqd agent publish --env <value> --path <value>
wiqd agent publish --json

wiqd agent validate

Validate agent manifests (static or deep).

Extension: Manifest Validation & LSP

wiqd agent validate [options]

Options

Option	Description
--path <value>	Agent project directory
--env <value>	Target environment (default: “local”)
--mode <value>	Validation mode: static or deep (choices: “static”, “deep”, default: “static”)
--package-file <value>	Path to a built .zip (deep mode only)

Examples

wiqd agent validate
wiqd agent validate --path <value> --env <value>
wiqd agent validate --json

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 monitor
wiqd agent monitor --query <value> --env <value>
wiqd agent monitor --json

wiqd agent ask

Send a message directly to a declarative agent.

Extension: Work IQ

wiqd agent ask [options]

Options

Option	Description
-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.

Examples

wiqd agent ask
wiqd agent ask --query <value> --agent-id <value>
wiqd agent ask --json

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 list
wiqd agent list --name <value> --id <value>
wiqd agent list --json

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”)
--concurrency <value>	Concurrent scenario runs (1-5) (default: 5)
--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..

Examples

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

wiqd agent eval init

Initialize an evaluation prompts.json for a project (drops a starter suite tailored to the default declarative-agent template, plus env/.env..user from your Azure OpenAI / tenant env vars).

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..user filename) (default: “local”)
--output <value>	Output prompts file (runevals auto-discovers evals/prompts.json) (default: “evals/prompts.json”)

Examples

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

wiqd plugin

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

Extension: wiqd (core)

wiqd plugin <command>

Examples

wiqd plugin
wiqd plugin add
wiqd plugin --help

wiqd plugin add

add

Extension: Agents Toolkit

wiqd plugin add <command>

Examples

wiqd plugin add
wiqd plugin add agent
wiqd plugin add skill
wiqd plugin add connector
wiqd plugin add --help

wiqd plugin add agent

Add a declarative agent component to a plugin.

Extension: Agents Toolkit

wiqd plugin add agent [options]

Options

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

Examples

wiqd plugin add agent
wiqd plugin add agent --folder <value>
wiqd plugin add agent --json

wiqd plugin add skill

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

Extension: Agents Toolkit

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
wiqd plugin add skill --name <value> --folder <value>
wiqd plugin add skill --json

wiqd plugin add connector

Add a remote MCP agent connector to the plugin manifest.

Extension: Agents Toolkit

wiqd plugin add connector [options]

Options

Option	Description
-n, --name <value>	Connector display name
--description <value>	Connector description
--url <value>	Remote MCP server https:// URL
-f, --folder <value>	Plugin project folder (defaults to CWD)

Examples

wiqd plugin add connector
wiqd plugin add connector --name <value> --description <value>
wiqd plugin add connector --json

wiqd plugin show

Show a summary of a standalone plugin project.

Extension: Agents Toolkit

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)

Examples

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

wiqd plugin list

List standalone plugin projects under a directory.

Extension: Agents Toolkit

wiqd plugin list [options]

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 list
wiqd plugin list --name <value> --top <value>
wiqd plugin list --json

wiqd plugin provision

Provision a plugin to an environment. Requires ATK sign-in; use wiqd auth login --interactive.

Extension: Agents Toolkit

wiqd plugin provision [options]

Options

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

Examples

wiqd plugin provision
wiqd plugin provision --env <value> --path <value>
wiqd plugin provision --json

wiqd plugin package

Package the plugin into a deployable .zip.

Extension: Agents Toolkit

wiqd plugin package [options]

Options

Option	Description
--env <value>	Environment to resolve variables from (default: “local”)
--output <value>	Output path for the zip package
--path <value>	Plugin project path (defaults to CWD)

Examples

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

wiqd plugin share

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

Extension: Agents Toolkit

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 share
wiqd plugin share --scope users --email <value>
wiqd plugin share --json

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 ATK sign-in; use wiqd auth login --interactive.

Extension: Agents Toolkit

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 delete
wiqd plugin delete --env <value> --path <value>
wiqd plugin delete --json

wiqd plugin create

Scaffold a new, empty standalone plugin project from ATK’s blank app template.

Extension: Agents Toolkit

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
wiqd plugin create --name <value> --output <value>
wiqd plugin create --json

wiqd plugin import

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

Extension: Agents Toolkit

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 (ATK 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 (ATK default: Auto) (choices: “Auto”, “None”, “OAuthPluginVault”, “ApiKeyPluginVault”)
--package-name <value>	Reverse-DNS package name

Examples

wiqd plugin import
wiqd plugin import --path <value> --output <value>
wiqd plugin import --json

wiqd plugin export

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

Extension: Agents Toolkit

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 /export/)
--format <value>	Target manifest kind (choices: “open-plugin”, “claude-plugin”, “cursor-plugin”, default: “open-plugin”)

Examples

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

wiqd plugin validate

Validate a standalone plugin project (static MVL; —mode deep validates the built package via ATK).

Extension: Manifest Validation & LSP

wiqd plugin validate [options]

Options

Option	Description
--path <value>	Plugin project directory (defaults to CWD)
--env <value>	Target environment (default: “local”)
--mode <value>	Validation mode: static or deep (choices: “static”, “deep”, default: “static”)
--package-file <value>	Path to a built .zip (deep mode only)

Examples

wiqd plugin validate
wiqd plugin validate --path <value> --env <value>
wiqd plugin validate --json

wiqd feedback

List and submit feedback about wiqd

Extension: wiqd (core)

wiqd feedback <command>

Examples

wiqd feedback
wiqd feedback list
wiqd feedback submit
wiqd feedback --help

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 list
wiqd feedback list --top <value> --status <value>
wiqd feedback list --json

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 submit
wiqd feedback submit --type <value> --title <value>
wiqd feedback submit --json

wiqd devui

Launch the local Work IQ DevUI web experience

Extension: wiqd (core)

wiqd devui <command>

Examples

wiqd devui
wiqd devui start
wiqd devui --help

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 start
wiqd devui start --agent <value> --transport direct
wiqd devui start --json

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 stop
wiqd devui stop --port <value>
wiqd devui stop --json

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
wiqd devui ask --query <value> --agent <value>
wiqd devui ask --json

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 config
wiqd devui config --client-id <value> --tenant <value>
wiqd devui config --json

Feature flags

Feature flags are typed toggles that gate experimental or environment-specific CLI behavior; the host registry ships empty and flags are contributed by active extensions (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.

After successfully setting or clearing plugin-core-engine, wiqd silently refreshes an already-installed plugin so its composed workflow and references match the selected backend. Other flag changes do not trigger a plugin reinstall. The backend refresh is a no-op when the plugin is not installed. If it fails, the flag change remains successful and wiqd prints a recovery hint; rerun wiqd install plugin manually.

Flag	Type	Default	Stage	Owner	Since	Description
plugin-core-engine	string-enum	atk	internal	wiqd-core	0.9.0	Selects the backend that services the agent lifecycle commands: the ATK subprocess (atk) or the in-process fx-core engine (fxcore).
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.
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. agent ask 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
plugin-core-engine	WIQD_FLAG_PLUGIN_CORE_ENGINE
devui	WIQD_FLAG_DEVUI
workiq-monitor	WIQD_FLAG_WORKIQ_MONITOR