Quick Tips (Critical)

This page is a one-stop checklist for the most common "fix it now" tasks in Wingman.

Re-sync bundled out-of-box agents

If your local .wingman/agents/ is missing bundled agents (or you want fresh templates), re-copy them without changing config/provider setup:

wingman init --mode sync --only agents

Only sync specific bundled agents:

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

Force overwrite existing agent template files:

wingman init --mode sync --only agents --force

See full agent details: Agents & Sub-Agents

Provider credentials not working

Check provider auth status:

wingman provider status

Log in again for a provider:

wingman provider login openai
wingman provider login codex

See provider setup guide: Providers

Gateway not responding

Check status/health:

wingman gateway status
wingman gateway health

Restart gateway:

wingman gateway restart

See gateway setup guide: Gateway Configuration

Quick local smoke test

Run one local prompt directly against your default/local agent:

wingman agent --local --agent main "hello"

If this works, core CLI + agent loading is healthy.

For more command detail, see CLI Reference.