CLI reference
Every redcell command and flag.
Run redcell COMMAND --help for the full details of any command.
Commands
Work
| Command | What it does |
|---|---|
redcell [PROMPT] | Start an interactive session |
redcell exec [PROMPT] | Run one task without a session. Alias: redcell e. See Run in scripts and CI |
redcell review | Review code changes in a Git repo |
Sessions
| Command | What it does |
|---|---|
redcell resume | Continue a saved session |
redcell fork | Copy a saved session and continue from the copy |
redcell archive SESSION | Archive a session |
redcell unarchive SESSION | Unarchive a session |
redcell delete SESSION | Permanently delete a session |
See Sessions.
Account
| Command | What it does |
|---|---|
redcell login | Sign in with your browser |
redcell login --with-api-key | Sign in with an API key from stdin |
redcell login status | Show how you're signed in |
redcell whoami | Show your account, plan, and CLI access |
redcell usage | Show your quota and when it resets |
redcell logout | Sign out |
See Sign in.
Extend
| Command | What it does |
|---|---|
redcell plugin | List, add, remove, and check plugins |
redcell plugin marketplace | Manage plugin marketplaces |
redcell mcp | Add, list, and remove MCP servers |
redcell mcp-server | Run RedCell as an MCP server over stdio |
redcell gateway | Run the Discord or Telegram gateway |
Maintenance
| Command | What it does |
|---|---|
redcell update | Update to the latest version |
redcell doctor | Check your install, config, sign-in, and connection. See Troubleshooting |
redcell config show | Show your effective settings for the current folder |
redcell features list | Show feature flags and whether each is on |
redcell features enable NAME | Turn a feature on in your config |
redcell features disable NAME | Turn a feature off in your config |
redcell completion SHELL | Print shell completions for bash, zsh, fish, powershell, or elvish |
redcell sandbox COMMAND | Run a command inside RedCell's sandbox (Linux) |
Global flags
These work with redcell, redcell resume, redcell fork, and most with redcell exec.
| Flag | What it does |
|---|---|
-m, --model MODEL | Use a specific model |
-C, --cd DIR | Use DIR as the working folder |
--add-dir DIR | Let RedCell also write to DIR |
-s, --sandbox MODE | read-only, workspace-write, or danger-full-access. See Permissions |
-a, --ask-for-approval POLICY | untrusted, on-request, or never |
-i, --image FILE | Attach images to the first prompt |
--search | Let RedCell search the web |
--oss | Use a local model through Ollama or LM Studio |
--local-provider NAME | ollama or lmstudio, with --oss |
-p, --profile NAME | Load ~/.redcell/NAME.config.toml on top of your config |
-c, --config KEY=VALUE | Override one config value for this run |
--enable FEATURE / --disable FEATURE | Turn a feature on or off for this run |
--strict-config | Fail if your config has keys this version doesn't know |
--no-alt-screen | Run inline and keep terminal scrollback |
--dangerously-bypass-approvals-and-sandbox | Turn off all safety checks. Only for disposable environments |
-V, --version | Print the version |
Environment variables
| Variable | What it does |
|---|---|
REDCELL_HOME | Where RedCell keeps config and data. Default ~/.redcell |
REDCELL_OSS_BASE_URL | URL of your local model server |
REDCELL_OSS_PORT | Port of your local model server |
REDCELL_PLUGIN_PREREQS | install, check, or skip for plugin tool checks |
RUST_LOG | Log level, for example RUST_LOG=debug |