Quick reference for all ChatCLI commands and flags.
Internal Commands (/)
| Command | Description |
|---|
/help | Show help |
/exit or /quit | Exit ChatCLI |
/newsession | Start a new conversation session |
/config or /status | Show current configuration |
/reload | Reload settings from .env |
/switch | Switch LLM provider or model |
/agent or /run | Start agent mode |
/coder | Start coder mode (code engineering) |
/auth | Manage OAuth credentials |
/clear | Redraw/clear screen |
/connect | Connect to remote server (gRPC) |
/disconnect | Disconnect from remote server |
/context | Manage persistent contexts |
/plugin | Manage plugins |
/skill | Manage skills from registries |
/session | Manage sessions |
/nextchunk | Load next file chunk |
/retry | Retry last failed chunk |
/retryall | Retry all failed chunks |
/skipchunk | Skip a file chunk |
/version | Check version |
/compact | Compact conversation history (auto or guided) |
/rewind | Rewind to a previous conversation checkpoint |
/memory | View/load memory annotations (today, yesterday, week, load, longterm, list) |
/watch | K8s watcher status |
Context Commands (@)
| Command | Description |
|---|
@file <path> | Attach file content or directory structure |
@file --mode <mode> | Mode: full, summary, chunked, smart |
@command <cmd> | Execute command and attach output as context |
@command --ai | Send output directly to AI for analysis |
@command -i | Interactive mode (e.g., ssh, vim) |
@git | Inject Git repository status, diff, and log |
@env | Inject environment variables (sensitive ones redacted) |
@history | Inject shell command history |
Agent Mode — Actions
| Action | Description |
|---|
[N] | Execute command number N |
a | Execute all pending commands |
eN | Edit command N |
tN | Simulate (dry-run) command N |
cN | Ask AI to continue with output from N |
pcN | Add pre-execution context |
acN | Add post-execution context |
vN | View full output in pager |
wN | Save output to temporary file |
p | Toggle compact/full view |
r | Redraw the screen |
q | Exit agent mode |
Sessions (/session)
| Command | Description |
|---|
/session save <name> | Save the current conversation |
/session load <name> | Load a saved conversation |
/session list | List all sessions |
/session delete <name> | Delete a session |
/session new | Start a clean session |
When connected to a remote server, sessions can be saved/loaded locally, remotely, or both.
Persistent Contexts (/context)
| Command | Description |
|---|
/context create <name> ... | Create snapshot of files/directories |
/context update <name> ... | Update existing context |
/context attach <name> | Attach context to current session |
/context detach <name> | Detach context |
/context list | List saved contexts |
/context show <name> | Show details and files |
/context inspect <name> | Detailed statistics |
/context delete <name> | Delete permanently |
/context merge <new> <c1> <c2> | Combine contexts |
/context attached | Show attached contexts with token estimates and cache hints |
/context export <name> <file> | Export to JSON |
/context import <file> | Import from JSON |
/context metrics | Usage statistics |
Skills (/skill)
| Command | Description |
|---|
/skill search <query> | Search across all registries (parallel fan-out) |
/skill install <name> | Install skill from a registry |
/skill uninstall <name> | Remove installed skill |
/skill list | List installed skills |
/skill info <name> | Skill metadata from registry |
/skill registries | Show configured registries |
/skill help | Help for the /skill command |
Command-Line Flags (One-Shot)
| Flag | Description |
|---|
-p, --prompt | Execute a prompt and exit |
--provider <name> | Override provider (e.g., CLAUDEAI) |
--model <name> | Override model |
--timeout <duration> | Time limit (e.g., 10s, 1m) |
--max-tokens <num> | Limit tokens in response |
--agent-auto-exec | Execute first safe command in agent mode |
--no-anim | Disable animations (useful in scripts) |
-v, --version | Show version |
-h, --help | Show help |
Subcommands
chatcli server
chatcli connect
chatcli watch
Starts as a gRPC server for remote access.| Flag | Description | Default |
|---|
--port <int> | gRPC port | 50051 |
--token <string> | Authentication token | "" |
--tls-cert <path> | TLS certificate | "" |
--tls-key <path> | TLS key | "" |
--provider <name> | Default LLM provider | Auto |
--model <name> | Default model | Auto |
--watch-deployment <name> | K8s deployment to monitor | "" |
--watch-namespace <ns> | Namespace | "default" |
--watch-interval <dur> | Collection interval | 30s |
--watch-window <dur> | Observation window | 2h |
--watch-max-log-lines <n> | Max log lines per pod | 100 |
--watch-kubeconfig <path> | Kubeconfig | Auto |
Connects to a remote server via gRPC.| Flag | Description | Default |
|---|
<address> | Address (positional) | |
--addr <host:port> | Address (flag) | "" |
--token <string> | Authentication token | "" |
--provider <name> | Override provider | "" |
--model <name> | Override model | "" |
--llm-key <string> | Your API key | "" |
--use-local-auth | Use OAuth from local auth store | false |
--tls | Enable TLS | false |
--ca-cert <path> | CA certificate | "" |
-p <prompt> | Remote one-shot | "" |
--raw | Unformatted output | false |
--max-tokens <int> | Max tokens | 0 |
Monitors K8s deployment with AI.| Flag | Description | Default |
|---|
--deployment <name> | Deployment (required) | "" |
--namespace <ns> | Namespace | "default" |
--interval <dur> | Collection interval | 30s |
--window <dur> | Observation window | 2h |
--max-log-lines <n> | Max log lines per pod | 100 |
--kubeconfig <path> | Kubeconfig | Auto |
--provider <name> | LLM provider | .env |
--model <name> | LLM model | .env |
-p <prompt> | One-shot with K8s context | "" |
--max-tokens <int> | Max tokens | 0 |
Compaction and Rewind
| Command | Description |
|---|
/compact | Automatic compaction (3-level pipeline) |
/compact <instruction> | Guided compaction — preserves specific information |
/rewind | Display checkpoint menu for restoration |
| Esc+Esc | Quick shortcut for /rewind (2x Esc within 500ms, only when input is empty) |
/compact accepts a natural language instruction. Example: /compact preserve file paths and decisions.
Keyboard Shortcuts
| Shortcut | Action |
|---|
| Alt/Option + arrows | Move cursor by word |
| Ctrl + arrows | Move cursor by word |
| Cmd + arrows / Home/End | Beginning/end of line |
| Esc+Esc | Open rewind menu (double Esc within 500ms, only when input is empty) |
| Shortcut | Action |
|---|
| Alt + Backspace | Delete word to the left |
| Ctrl + W | Delete word to the left |
| Ctrl + K | Delete from cursor to end of line |
Automatic detection via Bracketed Paste Mode:
- Small pastes (150 chars or less): rendered normally
- Large pastes (more than 150 chars): placeholder
«N chars | M lines»
The actual content is preserved and sent when pressing Enter.