wip help

wip help

Prints the same text as --help, or asks a local AI server how to do something in plain language.

wip help
wip help --ai [--url URL] [QUESTION...]

Plain usage

wip help alone prints exactly what wip --help prints. It's generated from the same command tree at run time rather than a copy kept in sync by hand, so the two can never drift apart:

$ wip help
Description:
  A developer-friendly CLI wrapper for Microsoft WSLC.

Usage:
  wip [command] [options]

Options:
  --config <config>        Path to wip.yml
  --env-file <env-file>    Path to a dotenv file (default: .env next to wip.yml)
  --debug                  Print progress and timing for each step
  --debug-log <debug-log>  Where --debug snapshots go: a file path, or "-" for inline
  -?, -h, --help           Show help and usage information
  --version                Show version information

Commands:
  version                 Show wip and WSLC versions
  init                    Create a starter wip.yml (detects an existing compose file)
  doctor                  Diagnose the development environment
  help <question>         Show usage help (add --ai to ask a local AI server instead)
  config                  Print the effective configuration
  build <extra>           Build the configured image
  up                      Start the configured container and its dependencies, creating them if necessary
  sync                    Mirror the source tree into the sync volume
  stop                    Stop the configured container and its dependencies without removing them
  down                    Stop and remove the configured container and its dependencies
  exec <command>          Execute a command in the running container
  run <command>           Run a command in a new container
  shell                   Open a shell in the configured container
  logs <services>         Follow logs from compose services (compose mode only)
  dispatch <name> <args>  Run a command defined in wip.yml

wip help takes no command name of its own — unlike git help <command>, it only ever shows the top-level listing above. A single subcommand's own flags still come from that subcommand directly:

wip up --help
wip sync --help

Flags

--ai [--url URL] [QUESTION...]

Skips printing --help and instead sends your question, together with the wip help text above as grounding context, to a local AI server — the same Ollama / LM Studio / any-OpenAI-compatible-server setup that wip init --ai uses, through the same LocalAiProvider. Everything on AI-Assisted Initialization about configuring WIP_AI_BASE_URL / WIP_AI_MODEL, model auto-discovery, and troubleshooting applies here unchanged — this page only covers what's specific to help.

--url URL overrides WIP_AI_BASE_URL for that one run, exactly like wip doctor --url and wip init --ai --url:

wip help --ai --url http://localhost:1234/v1 how do I keep syncing files while I work

The question can be given inline as trailing words — no quoting needed:

$ wip help --ai how do I restart a dependency automatically when it crashes
wip: asking llama3.1 at http://localhost:11434/v1
Set `restart: unless-stopped` (or `always`) on that dependency in wip.yml, then run
`wip up --watch`. wip polls every --interval seconds (default 5) and restarts any
dependency that has exited and whose restart: policy allows it. See "Auto Restarting
Containers" and "Restart Policies" on the wiki for the full behavior.

Omit the question and wip prompts for one interactively instead — the same blank-line-terminated convention as wip init --ai, since a question can span more than one line too:

$ wip help --ai
Ask wip how to do something, then press Enter twice (once after your question,
once more on a blank line) to finish:
What's the difference between wip stop and wip down?

wip: asking llama3.1 at http://localhost:11434/v1
`wip stop` stops the configured container and its dependencies but leaves them in place, so
`wip up` afterward just starts them again. `wip down` stops them and removes them, so the next
`wip up` recreates them from scratch. Prefer `stop` when you just want to pause; `down` when you
want a clean slate or are done with the project for now.

The answer is generated text, not a lookup. It's grounded in the reference above and instructed to say so rather than guess when something isn't covered, but a small local model can still misread its own reference material — verify anything it tells you to run, the same caution AI-Assisted Initialization gives for a generated wip.yml.

--url without --ai

$ wip help --url http://localhost:1234/v1
wip: --url requires --ai

A question without --ai

$ wip help how do I sync files
wip: a question requires --ai

Both fail before touching the network or reading wip.yml — same as wip init --template x --ai rejecting the combination up front.

What gets sent

Only the question and the wip --help text: command names, one-line descriptions, and global options. No project files, no wip.yml, no environment variables — a smaller, static payload compared to what wip init --ai sends. There's also nothing to confirm or save afterward; wip help --ai only ever prints an answer.

Related

• wip doctor — --url, and the local AI availability check both commands share
• wip init — --ai, the other command that talks to a local AI server
• AI-Assisted Initialization — server setup, model auto-discovery, troubleshooting (/v1, ambiguous models, timeouts) — all of it applies to wip help --ai too
• CLI Command Reference