CLI Reference
Every cortex command, grouped by area. All commands accept --config / -c <path> to point at a non-default config file.
Gateway
| Command | Description |
|---|
cortex start [--background] [--bind HOST] [--port PORT] | Start the gateway daemon |
cortex stop | Stop a daemon started with --background |
cortex status | Show agent config, enabled channels, and memory stats |
cortex chat | Talk to your agent directly from the terminal |
Config
| Command | Description |
|---|
cortex config show | Print the fully resolved config |
cortex config init | Write a default config.toml |
cortex config edit | Open config.toml in $EDITOR |
Channels
| Command | Description |
|---|
cortex channels list | Show configured channels and their status |
cortex channels add <name> | Guided setup for one channel |
cortex channels remove <name> | Disable a channel |
Tools
| Command | Description |
|---|
cortex tools list | Show built-in and plugin-contributed tools |
Voice
| Command | Description |
|---|
cortex voice clone <name> <audio_files...> | Upload an ElevenLabs custom voice from sample audio |
Memory
| Command | Description |
|---|
cortex memory prune | Delete low-importance long-term memory entries |
cortex memory clear | Wipe all long-term memory |
cortex memory edit <id> | Edit a memory entry's content and/or importance score |
cortex memory archive | Condense inactive sessions into dense summaries |
cortex memory search <query> [--tag TAG] | Search long-term memory |
Misc
| Command | Description |
|---|
cortex init [--force] [--dir PATH] | Guided first-run setup wizard |
cortex version | Print the installed version |
cortex update [--check] | Check PyPI for a newer version, optionally install it |