Commands

Every capability is available two ways: as a slash command inside the interactive shell, and as a direct command you can script.

Two ways to run commands

Interactive shell — inside cos, type / then the command (e.g. /sessions).
Direct command — from your terminal, run it as a subcommand (e.g. cos sessions). Ideal for scripts and CI.

Slash commands

Authentication

Command	Purpose	Example
/login	Store and verify your secret API key	/login
/logout	Remove the stored key and session from this machine	/logout
/whoami	Show the active workspace, project, and account	/whoami

text

❯ /whoami
  Workspace    Default workspace
  Project      Project A
  Account      test@carrieros.ai

Sessions

Command	Purpose	Example
/sessions	List conversations in the current project	/sessions
/session use [id]	Switch the active session (picker if no id)	/session use
/session delete <id>	Delete a session	/session delete 25f3…
/history [id]	Print a transcript of the active (or given) session	/history
/clear	Start a fresh session (also /new)	/clear

Files

Command	Purpose	Example
/upload <file>	Upload and index a file as knowledge	/upload report.pdf
/files	List files uploaded from this machine	/files

Models & Modes

Command	Purpose	Example
/models	List provider models (GPT, Grok, Claude, …)	/models
/model [id]	Set the provider model, or auto (picker if no id)	/model
/modes	List Carrier modes (behavior presets)	/modes
/mode [id]	Set the Carrier mode (picker if no id)	/mode

text

❯ /model
  Select a model
  Switch the model for this and future messages.

    1. Auto (mode default)   Use the current mode default
  ❯ 2. GPT-5.5               gpt-5.5             ✓
    3. Grok 4.1 Fast         grok-4.1-fast

  ↑↓ navigate · Enter confirm · Esc cancel

Utilities

Command	Purpose	Example
/doctor	Run diagnostics (config, connectivity, key)	/doctor
/usage	Requests, tokens, and estimated cost	/usage
/version	CLI and API versions	/version
/help	Browse every command (arrow-navigable)	/help
/exit	Leave the shell	/exit

Direct commands

Every slash command is also a plain subcommand. A few examples used most often when scripting:

Command	Purpose	Example
cos login [--url]	Store the secret key (only after it verifies)	cos login --url http://localhost:5000/v1
cos doctor	Config, connectivity, and key checks	cos doctor
cos whoami	Workspace / project / account	cos whoami
cos chat	Focused chat REPL (a subset of the shell)	cos chat --mode code
cos usage	Requests, tokens, estimated cost	cos usage
cos upload <file>	Upload + index a file	cos upload report.pdf
cos models	List provider models	cos models
cos guide	Styled workflow overview	cos guide
cos version	CLI + API versions	cos version

Prefer cos, but carrieros works everywhere too — they are the same binary.