CFactory CLI
The CFactory CLI (@cfactory/cli, binary cfactory) runs the same agent engine as the editor — interactively (TUI) or headlessly in CI.
Install
npm install -g @cfactory/cli
Common commands
# Interactive session in the current project cfactory # One-shot task cfactory run "fix failing tests" # Autonomous mode (no permission prompts — trusted environments only) cfactory run --auto "run tests and fix failures" # Local HTTP API for editor / integrations cfactory serve
See the command reference.
Configuration
Prefer project and user config under .cfactory/ and cfactory.json.
Typical locations:
| Scope | Path |
|---|---|
| User | ~/.config/cfactory/cfactory.json |
| Project | ./cfactory.json or ./.cfactory/ |
Use config for models, MCP servers, permissions, and agent defaults. Schema notes for contributors: CLI config schema.
MCP in the CLI
See Using MCP in CLI.