Skip to Content
REDCELLDocs

CLI reference

Every redcell command and flag.

Run redcell COMMAND --help for the full details of any command.

Commands

Work

CommandWhat 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 reviewReview code changes in a Git repo

Sessions

CommandWhat it does
redcell resumeContinue a saved session
redcell forkCopy a saved session and continue from the copy
redcell archive SESSIONArchive a session
redcell unarchive SESSIONUnarchive a session
redcell delete SESSIONPermanently delete a session

See Sessions.

Account

CommandWhat it does
redcell loginSign in with your browser
redcell login --with-api-keySign in with an API key from stdin
redcell login statusShow how you're signed in
redcell whoamiShow your account, plan, and CLI access
redcell usageShow your quota and when it resets
redcell logoutSign out

See Sign in.

Extend

CommandWhat it does
redcell pluginList, add, remove, and check plugins
redcell plugin marketplaceManage plugin marketplaces
redcell mcpAdd, list, and remove MCP servers
redcell mcp-serverRun RedCell as an MCP server over stdio
redcell gatewayRun the Discord or Telegram gateway

Maintenance

CommandWhat it does
redcell updateUpdate to the latest version
redcell doctorCheck your install, config, sign-in, and connection. See Troubleshooting
redcell config showShow your effective settings for the current folder
redcell features listShow feature flags and whether each is on
redcell features enable NAMETurn a feature on in your config
redcell features disable NAMETurn a feature off in your config
redcell completion SHELLPrint shell completions for bash, zsh, fish, powershell, or elvish
redcell sandbox COMMANDRun a command inside RedCell's sandbox (Linux)

Global flags

These work with redcell, redcell resume, redcell fork, and most with redcell exec.

FlagWhat it does
-m, --model MODELUse a specific model
-C, --cd DIRUse DIR as the working folder
--add-dir DIRLet RedCell also write to DIR
-s, --sandbox MODEread-only, workspace-write, or danger-full-access. See Permissions
-a, --ask-for-approval POLICYuntrusted, on-request, or never
-i, --image FILEAttach images to the first prompt
--searchLet RedCell search the web
--ossUse a local model through Ollama or LM Studio
--local-provider NAMEollama or lmstudio, with --oss
-p, --profile NAMELoad ~/.redcell/NAME.config.toml on top of your config
-c, --config KEY=VALUEOverride one config value for this run
--enable FEATURE / --disable FEATURETurn a feature on or off for this run
--strict-configFail if your config has keys this version doesn't know
--no-alt-screenRun inline and keep terminal scrollback
--dangerously-bypass-approvals-and-sandboxTurn off all safety checks. Only for disposable environments
-V, --versionPrint the version

Environment variables

VariableWhat it does
REDCELL_HOMEWhere RedCell keeps config and data. Default ~/.redcell
REDCELL_OSS_BASE_URLURL of your local model server
REDCELL_OSS_PORTPort of your local model server
REDCELL_PLUGIN_PREREQSinstall, check, or skip for plugin tool checks
RUST_LOGLog level, for example RUST_LOG=debug