wrap

Use capa wrap when you want capa’s install output in a shadow workspace under ~/.capa/workspaces instead of writing provider files into the project tree.

Synopsis

capa wrap [provider] [args...] [--project <dir>] [--print-dir] [--prune]

If you omit provider, capa prompts (TTY) for a wrappable provider. Extra [args...] are forwarded to the provider binary.

Flags

Flag	Description
--project <dir>	Source project directory (default: current working directory)
--print-dir	Print the workspace path before launching
--prune	Remove wrap workspaces under ~/.capa/workspaces and exit

Behavior

1. Resolves the provider (prompt if omitted).
2. Fails fast if the provider launch binary is missing from PATH.
3. Prepares a shadow workspace and installs capa-managed artifacts there.
4. Launches the provider against that workspace.

Caution

If the provider binary is not on PATH, capa wrap exits before creating a workspace. Install the CLI (for example Cursor Agent or Claude Code) and retry.

capa stop also stops active wrap sessions. See Server lifecycle.

Examples

capa wrap
capa wrap cursor
capa wrap claude-code --print-dir
capa wrap cursor --project ../other-app
capa wrap --prune

See also

• Wrap workspaces
• Quick Start (wrap)
• install
• Server lifecycle