Command Palette

Search conversations, projects, playbooks, and more

CLI

Complete command reference for the crewkit CLI.

The crewkit CLI manages your AI coding sessions, team configuration, and project setup from the terminal.

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.

crewkit code                          # Native Claude Code, crewkit alongside
crewkit tui                           # The same session in crewkit's terminal interface

Terminal interface

crewkit's opt-in terminal interface (TUI) — a live sidebar with session metrics, git context, and AI summaries.

Dashboard

Navigate the crewkit web dashboard to view sessions, analytics, and team settings.

On this page

Commandscrewkit codecrewkit tuicrewkit sidecarcrewkit initcrewkit authcrewkit orgcrewkit projectcrewkit memberscrewkit resourcescrewkit playbookscrewkit sessionscrewkit blueprintcrewkit save-statecrewkit lspcrewkit mcpUtility commandsGlobal flagsNext steps
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 <id> # 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:

FlagDescription
--debugEnable debug logging (per-session log at .crewkit/debug-latest.log)
-v, --verboseShow detailed output (file lists, timing)
-p, --prompt <text>Run headless with a prompt
--output-format <fmt>Output format: text, json, stream-json (requires --prompt)
--timeout <secs>Max execution time for headless mode (default: 300)
-q, --quietSuppress progress output in headless mode
-c, --continue-sessionContinue most recent Claude session
-r, --resume [id]Resume a session by ID, or show picker
--fork-sessionFork the resumed session (new ID, existing context)
--sensitiveMark session as sensitive (excluded from cross-repo discovery)
--repo-id <id>Explicit repository ID (also: CREWKIT_REPOSITORY_ID env var)
-y, --yesSkip interactive prompts (for CI/CD)
--no-authSkip authentication (sessions will not be tracked)
--no-statuslineDon't add the crewkit statusline to the Claude Code session
--statusShow the background observers for this directory (same as crewkit sidecar status)
--stopStop this terminal's background observer (same as crewkit sidecar stop; --all stops every observer for the directory)
--no-artifactsDisable artifact context injection into the session
--no-contextSkip injecting save-state recall context (personal + team digests)
--no-titleDisable terminal window title
--disable-lspDisable LSP server auto-start
--chromeUse Chrome for browser automation
--llm-gatewayEnable LLM gateway proxy
--llm-gateway-port <port>Gateway proxy port (default: ephemeral)
--dangerously-skip-permissionsSkip 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.

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).

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.

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.

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.

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.

crewkit project list                                  # List projects
crewkit project create "My Project" --org acme       # Register without prompts
crewkit project info                                  # Show current project

crewkit project create <NAME> [--org <SLUG_OR_ID>] 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.

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).

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.

crewkit playbooks list              # List playbooks
crewkit playbooks list --detail     # Show convention details
crewkit playbooks show <id>         # Show specific playbook

crewkit sessions

Browse, inspect, share, and report on sessions.

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 <id>                       # 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:

crewkit sessions share <id>                      # Org-visible link, expires in 7 days
crewkit sessions share <id> --access public      # Anyone with the link (requires admin)
crewkit sessions share <id> --level summary      # Levels: summary, transcript, full
crewkit sessions share <id> --expires 0          # Never expires
crewkit sessions share <id> --list               # List existing shares
crewkit sessions share <id> --revoke <share-id>  # Revoke a share

Import history — bring in local Claude Code JSONL transcripts:

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 <transcript-id>          # Import specific conversation

Most subcommands accept --json for piping.

crewkit blueprint

AI-powered project planning with epics and tasks.

crewkit blueprint create "Ship the billing revamp"  # Generate a blueprint from a goal
crewkit blueprint list                              # List blueprints for this project
crewkit blueprint show <id>                         # Epics and tasks
crewkit blueprint review                            # Review against the local codebase
crewkit blueprint tasks --status pending            # List tasks, filter by status
crewkit blueprint start <task-id>                   # Claim a task (sets in_progress)
crewkit blueprint complete <task-id>                # 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).

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 <id>          # Delete a save state

crewkit lsp

Code intelligence server for Claude Code.

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.

crewkit mcp serve                     # Start the stdio MCP server
crewkit mcp serve --org <id>          # Override organization detection
crewkit mcp serve --project <id>      # Override project detection

Utility commands

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

FlagDescription
--no-colorDisable colors (also respects NO_COLOR env var)
--plainASCII-only output (no unicode symbols)
--debugEnable debug logging (per-session log at .crewkit/debug-latest.log)
--versionShow version
--helpShow help

Next steps

  • Terminal interface
  • Configuration