Skip to content

cli.md

Latest commit

 

History

History
159 lines (116 loc) · 3.88 KB

cli.md

File metadata and controls

159 lines (116 loc) · 3.88 KB

CLI reference

This page documents the currently implemented CLI entrypoints. The main user workflow is the TUI; use this page as a supporting reference.

Top-level usage

usage: codelia [options] [-- <tui-options>]

Top-level options

Option Meaning
-h, --help Show top-level help
-V, -v, --version Show the CLI version
-p, --prompt <text> Run one headless prompt and exit
`--approval-mode <minimal trusted

TUI startup options

These flags are passed through to the TUI launcher:

Option Meaning
-r, --resume [session_id] Resume through the latest/session picker flow, or resume a specific session id
`--debug[=true false]`
`--diagnostics[=true false]`
--initial-message <text> Queue an initial prompt
--initial-user-message <text> Alias of --initial-message
`--debug-perf[=true false]`
`--approval-mode <minimal trusted

Examples:

codelia
codelia --resume
codelia --resume 2026-03-07-example-session
codelia --initial-message "Review the latest changes"
codelia --diagnostics --approval-mode trusted

Prompt mode

Run a single headless request:

codelia --prompt "Summarize the current branch"

Prompt mode also accepts --approval-mode.

MCP commands

The MCP command group currently supports config management and auth token management.

Overview

codelia mcp <add|list|remove|enable|disable|test|auth> ...

mcp list

List configured servers.

codelia mcp list
codelia mcp list --scope effective
codelia mcp list --scope project
codelia mcp list --scope global

Supported scopes:

  • effective (default)
  • project
  • global

mcp add

Add or replace an MCP server config.

codelia mcp add <server-id> --transport <http|stdio> ...

Common flags:

  • --scope <project|global>
  • --replace
  • --enabled true|false
  • --request-timeout-ms <ms>

HTTP transport flags:

  • The CLI/config value is http; the current implementation behind it is Streamable HTTP.
  • --url <url>
  • --header key=value (repeatable)
  • --oauth-authorization-url <url>
  • --oauth-token-url <url>
  • --oauth-registration-url <url>
  • --oauth-client-id <value>
  • --oauth-client-secret <value>
  • --oauth-scope <value>

stdio transport flags:

  • --command <path-or-command>
  • --arg <value> (repeatable)
  • --cwd <path>
  • --env key=value (repeatable)

Examples:

codelia mcp add local-demo --transport stdio --command uvx --arg my-mcp
codelia mcp add remote-demo --transport http --url https://example.com/mcp --scope global

mcp remove, mcp enable, mcp disable

codelia mcp remove <server-id> [--scope project|global]
codelia mcp enable <server-id> [--scope project|global]
codelia mcp disable <server-id> [--scope project|global]

mcp test

Probe a configured MCP server.

codelia mcp test <server-id> [--scope effective|project|global]

If a stored auth token exists for an HTTP server, the test command adds a bearer token automatically.

mcp auth

Manage MCP auth tokens stored in the local auth file.

codelia mcp auth <list|set|clear> ...

Commands:

codelia mcp auth list
codelia mcp auth set <server-id> --access-token <token> [--refresh-token <token>] [--expires-at <epoch_ms>] [--expires-in <sec>] [--scope <scope>] [--token-type <type>]
codelia mcp auth clear <server-id>

Related docs