--- source: CrewKit documentation url: https://crewkit.io/docs/cli.md title: "CLI" description: "Complete command reference for the crewkit CLI." --- The crewkit CLI manages your AI coding sessions, team configuration, and project setup from the terminal. ```bash crewkit # Start a coding session — Claude Code runs here, crewkit observing crewkit code # Start a coding session crewkit auth login # Connect to your account ``` Bare `crewkit` is the same as `crewkit code` — every launch flag works bare (`crewkit -c`, `crewkit -p "..."`, `crewkit --sensitive`). A flagless `crewkit` with piped or captured output shows the setup overview instead, which also lives at `crewkit status`. --- ## Commands ### crewkit code Start a coding session with your team's agents. ```bash crewkit code # Native Claude Code, crewkit alongside crewkit tui # The same session in crewkit's terminal interface crewkit code --prompt "Fix the bug" # Headless one-shot crewkit code -c # Continue most recent session crewkit code --resume # Pick a session to resume crewkit code --resume # Resume specific session ``` By default on macOS and Linux, `crewkit code` launches the native `claude` — Claude Code owns the terminal exactly as if you'd run it directly — while crewkit loads beside it in the background: session tracking, telemetry, and team context. crewkit adds a statusline to the Claude Code session on every observed launch (opt out with `--no-statusline`, `CREWKIT_STATUSLINE=off`, or `[statusline] enabled = false` in `.crewkit/config.toml`). If the background observer cannot be set up, the launch fails with the reason rather than silently starting an unobserved session — run `crewkit tui` if you want the interactive terminal interface. On Windows, the interactive terminal interface remains the default. **Flags:** | Flag | Description | |------|-------------| | `--debug` | Enable debug logging (per-session log at `.crewkit/debug-latest.log`) | | `-v, --verbose` | Show detailed output (file lists, timing) | | `-p, --prompt ` | Run headless with a prompt | | `--output-format ` | Output format: `text`, `json`, `stream-json` (requires `--prompt`) | | `--timeout ` | Max execution time for headless mode (default: 300) | | `-q, --quiet` | Suppress progress output in headless mode | | `-c, --continue-session` | Continue most recent Claude session | | `-r, --resume [id]` | Resume a session by ID, or show picker | | `--fork-session` | Fork the resumed session (new ID, existing context) | | `--sensitive` | Mark session as sensitive (excluded from cross-repo discovery) | | `--repo-id ` | Explicit repository ID (also: `CREWKIT_REPOSITORY_ID` env var) | | `-y, --yes` | Skip interactive prompts (for CI/CD) | | `--no-auth` | Skip authentication (sessions will not be tracked) | | `--no-statusline` | Don't add the crewkit statusline to the Claude Code session | | `--status` | Show the background observers for this directory (same as `crewkit sidecar status`) | | `--stop` | Stop this terminal's background observer (same as `crewkit sidecar stop`; `--all` stops every observer for the directory) | | `--no-artifacts` | Disable artifact context injection into the session | | `--no-context` | Skip injecting save-state recall context (personal + team digests) | | `--no-title` | Disable terminal window title | | `--disable-lsp` | Disable LSP server auto-start | | `--chrome` | Use Chrome for browser automation | | `--llm-gateway` | Enable LLM gateway proxy | | `--llm-gateway-port ` | Gateway proxy port (default: ephemeral) | | `--dangerously-skip-permissions` | Skip all permission prompts (CI/CD only — disables safety checks) | `--no-tui` is deprecated: it named the old opt-out, and its behavior — native Claude Code with crewkit alongside — is now the default. `--tui` likewise still parses, but the documented spelling is `crewkit tui`. --- ### crewkit tui Start the same coding session inside crewkit's interactive terminal interface — a live sidebar with session metrics, git context, and AI summaries. ```bash crewkit tui # Coding session with the live sidebar crewkit tui -c # Session launch flags work here too ``` `crewkit tui` takes the session launch flags (`-c/--continue-session`, `--resume`, `--sensitive`, ...) but not headless `-p` — headless is `crewkit -p "..."`. On Windows, this interface is the default under every spelling. --- ### crewkit sidecar An alias of `crewkit code` — the same launch under a second name. Its `status` and `stop` subcommands inspect or stop the background observers that ship with the default launch (macOS and Linux). ```bash crewkit sidecar # Launch claude with a background observer crewkit sidecar status # Show observer state for this project crewkit sidecar status --json # Machine-readable state crewkit sidecar stop # Stop the observer in this terminal crewkit sidecar stop --all # Stop every observer for this directory ``` Note: `crewkit sidecar status` reports the background observers, while `crewkit status` shows the setup overview. --- ### crewkit init Pin a single-repository mapping locally, or create a multi-repository workspace. ```bash crewkit init # Pin the detected mapping in .agent/config.yml crewkit init --yes # The same prompt-free local pin for a single repo crewkit init --workspace # Create and register a workspace project ``` Single-repository init does not create a project on the server. Use `crewkit project create` for registration; `--yes` does not change that boundary. Workspace init still creates the workspace project server-side. --- ### crewkit auth Manage authentication. ```bash crewkit auth login # Log in via device flow crewkit auth logout # Log out and clear tokens crewkit auth status # Show current auth status ``` --- ### crewkit org Organization management. ```bash crewkit org info # Show current org info crewkit org info --org acme # Show specific org crewkit org update --name "Acme" # Update org name crewkit org delete --org acme # Delete org (requires --force) ``` --- ### crewkit project Project management. ```bash crewkit project list # List projects crewkit project create "My Project" --org acme # Register without prompts crewkit project info # Show current project ``` `crewkit project create [--org ]` registers a repository project server-side without onboarding or device-flow prompts. Use an explicit organization slug or external ID for deterministic CI and BYOC setup. Inside a git repository, crewkit includes the detected origin remote; outside git, creation still works when `--org` is supplied. This command does not write local configuration. --- ### crewkit members Team member management. ```bash crewkit members list # List members crewkit members invite user@example.com # Invite (default: member role) crewkit members invite user@example.com -r admin # Invite as admin crewkit members update user@example.com -r admin # Change role crewkit members remove user@example.com # Remove member crewkit members invitations # List pending invitations ``` --- ### crewkit resources View and manage resources (agents, skills, commands, rules). ```bash crewkit resources list # List all resources crewkit resources list --type agent # Filter by type crewkit resources show rails-expert # Show resource details crewkit resources inspect rails-expert # Inspect full config crewkit resources import # Import local resources crewkit resources import --dry-run # Preview import ``` --- ### crewkit playbooks Preview applicable playbooks. ```bash crewkit playbooks list # List playbooks crewkit playbooks list --detail # Show convention details crewkit playbooks show # Show specific playbook ``` --- ### crewkit sessions Browse, inspect, share, and report on sessions. ```bash crewkit sessions list # Recent sessions (current project) crewkit sessions list --all-projects # Across the whole organization crewkit sessions list --since 7d --user me # Your sessions from the last week crewkit sessions show # Full detail (accepts short id prefix) crewkit sessions report --week # Team digest: sessions, cost, top agents ``` **Share a session** — create, list, or revoke share links: ```bash crewkit sessions share # Org-visible link, expires in 7 days crewkit sessions share --access public # Anyone with the link (requires admin) crewkit sessions share --level summary # Levels: summary, transcript, full crewkit sessions share --expires 0 # Never expires crewkit sessions share --list # List existing shares crewkit sessions share --revoke # Revoke a share ``` **Import history** — bring in local Claude Code JSONL transcripts: ```bash crewkit sessions import # Import local Claude conversations crewkit sessions import --since 2026-01-01 # Import recent only crewkit sessions import --dry-run # Preview what would import crewkit sessions import # Import specific conversation ``` Most subcommands accept `--json` for piping. --- ### crewkit blueprint AI-powered project planning with epics and tasks. ```bash crewkit blueprint create "Ship the billing revamp" # Generate a blueprint from a goal crewkit blueprint list # List blueprints for this project crewkit blueprint show # Epics and tasks crewkit blueprint review # Review against the local codebase crewkit blueprint tasks --status pending # List tasks, filter by status crewkit blueprint start # Claim a task (sets in_progress) crewkit blueprint complete # Mark a task completed crewkit blueprint export # Export as a plan file to .claude/work/ ``` --- ### crewkit save-state Manage project save states (personal handoffs + team digests). ```bash crewkit save-state ls # List this project's save states crewkit save-state show personal # Show your handoff crewkit save-state show team # Show the most recent team digest crewkit save-state rm # Delete a save state ``` --- ### crewkit lsp Code intelligence server for Claude Code. ```bash crewkit lsp install # Install plugin (user-wide) crewkit lsp install --project # Install for current project crewkit lsp uninstall # Remove plugin crewkit lsp status # Check installation crewkit lsp start # Start LSP server (usually auto-started) ``` --- ### crewkit mcp MCP server exposing crewkit's project memory to agents. Any MCP-capable agent can pull project context, conventions, prior work, active work, and blueprint state. Sessions launched by `crewkit code` register it automatically. ```bash crewkit mcp serve # Start the stdio MCP server crewkit mcp serve --org # Override organization detection crewkit mcp serve --project # Override project detection ``` --- ### Utility commands ```bash crewkit status # Setup overview (auth, project, sync state) crewkit status --json # Machine-readable overview crewkit whoami # Show current user crewkit update # Update crewkit crewkit update --check # Check for updates crewkit feedback "message" # Send feedback crewkit completions zsh # Generate shell completions (bash, zsh, fish, ...) ``` --- ## Global flags | Flag | Description | |------|-------------| | `--no-color` | Disable colors (also respects `NO_COLOR` env var) | | `--plain` | ASCII-only output (no unicode symbols) | | `--debug` | Enable debug logging (per-session log at `.crewkit/debug-latest.log`) | | `--version` | Show version | | `--help` | Show help | --- ## Next steps - [Terminal interface](/docs/tui) - [Configuration](/docs/configuration)