Codebolt CLI Reference

The codebolt CLI is the command-line interface for running the CodeBolt server, launching the TUI, executing headless prompts, scaffolding extensions, and talking to a running server over the command bridge.

This reference is based on the source in packages/cli/src.

What's In This Section

Section	What it covers
Root Command	Top-level codebolt options, runtime modes, and the top-level command groups
Action Commands	codebolt action ... for creating, publishing, and listing extensions
Server Commands	codebolt command ... for threads, tasks, jobs, agents, git, projects, todos, chat, and LLM operations

CLI Surfaces

Surface	Purpose
codebolt	Start the server, launch the TUI, connect to an existing server, or run a headless prompt
codebolt action ...	Manage extension types like agents, tools, plugins, skills, capabilities, executors, and action blocks
codebolt agent ...	Top-level shortcut for the same command group as codebolt action agent ...
codebolt command ...	Connect to a running CodeBolt server and execute server-backed command modules

Implementation Notes

• The root CLI is defined in packages/cli/src/index.ts.
• codebolt action ... is built from packages/cli/src/actions/*.ts.
• codebolt command ... is built from packages/cli/src/commands/*.ts.
• The codebolt action ... flow starts a temporary local server context via executeAction() before calling extension endpoints.
• The codebolt command ... flow expects a running server and inherits --port, --host, and --json from codebolt command.

See Also

• codeboltjs Reference — agent SDK reference
• Agent Framework Reference — runtime/framework internals