CLI Reference

    Global options

    • --workspace <path>: workspace root to use for .wingman config, agents, browser profiles, and extensions
    • --config-dir <dir>: config directory name (default: .wingman)

    wingman agent

    Run an agent with a prompt.

    wingman agent --agent <name> [options] "your prompt"

    Options:

    • --agent <name>: agent id (required if no default agent)
    • --local: run without the gateway
    • --gateway <url>: gateway WebSocket URL
    • --token <token>: gateway token
    • --password <value>: gateway password
    • --output=<mode>: interactive | json
    • -v / -vv: log verbosity
    • --verbose=<level>: debug | info | warn | error | silent

    wingman init

    Bootstrap .wingman/ config and install bundled agents.

    wingman init [options]
wingman init <agent-name>

    Options:

    • --agent <name>
    • --mode <name> (onboard | sync)
    • --only <targets> (config,agents,provider)
    • --agents <list> (comma-separated bundled agents)
    • --model <provider:model>
    • --provider <name> (anthropic | openai | codex | openrouter | copilot | xai)
    • --token / --api-key
    • --fs-root <path>
    • --merge, --force, --yes

    Bundled agent sync (no config/provider changes):

    wingman init --mode sync --only agents
wingman init --mode sync --only agents --agents main,coding
wingman init --mode sync --only agents --force

    Default browser baseline written by wingman init (when config is created or merged):

    • browser.defaultProfile: "default"
    • browser.profiles.default: ".wingman/browser-profiles/default"
    • browser.extensions.wingman: ".wingman/browser-extensions/wingman"
    • browser.defaultExtensions: ["wingman"]
    • Auto-installs the bundled extension files into .wingman/browser-extensions/wingman

    wingman provider

    wingman provider login <provider>
wingman provider logout <provider>
wingman provider status

    wingman skill

    wingman skill browse
wingman skill install <name>
wingman skill list
wingman skill remove <name>

    wingman browser

    Browser command details live on the dedicated setup page: Browser Automation.

    Mode-specific guides:

    wingman browser profile init <profile-id>
wingman browser profile open [profile-id]
wingman browser extension install [extension-id]
wingman browser extension pair
wingman browser extension path <extension-id>
wingman browser extension list

    Notes:

    • wingman browser extension install with no ID installs Wingman's bundled extension as wingman.
    • wingman browser extension pair enables secure local relay settings and generates a relay token for the extension options page.

    wingman gateway

    wingman gateway start
wingman gateway stop
wingman gateway restart
wingman gateway status
wingman gateway run
wingman gateway join <url>
wingman gateway discover
wingman gateway tunnel <ssh-host>
wingman gateway token --generate
wingman gateway health

    Common options:

    • --host, --port
    • --auth, --auth-mode <token|password|none>
    • --token, --password
    • --discovery <mdns|tailscale>
    • --name <string>