CLI Reference
Most Used Commands
The commands you will use day-to-day:
| Command | What it does |
|---|---|
remi | Start Claude Code with remote monitoring in the current directory |
remi ls | List running sessions (local or remote with --host) |
remi attach [id] | Attach your terminal to a running session (detach: Ctrl+B d) |
remi code | Show your connection code for remote access from the web/mobile app |
remi recent | Browse recent project directories |
All Commands (A-Z)
| Command | Description | Details |
|---|---|---|
remi attach [id] | Attach terminal to a running session | sessions |
remi authorize <key-file> | Add a client public key to authorized keys | auth |
remi code | Show or refresh connection code | remote |
remi detach [name] | Detach from current or named session | sessions |
remi export-key | Export identity for sharing across devices | identity |
remi import-key [file] | Import identity from file or stdin | identity |
remi keygen | Generate Ed25519 identity keypair | identity |
remi keys | List authorized client keys | auth |
remi kill <name> | Kill a session by name or ID | sessions |
remi config | Show, initialize, or inspect configuration | service |
remi logs | Show recent daemon logs | service |
remi ls | List live sessions from running daemon | sessions |
remi new | Start a new session (with optional remote/directory flags) | sessions |
remi recent | Browse recent project directories | sessions |
remi reload | Hot-reload config on running daemons | service |
remi start | Start daemon in background | service |
remi status | Show daemon status | service |
remi stop | Stop background daemon | service |
remi [claude-args] | Start Claude Code with remote monitoring (wrapper mode) | start |
remi --daemon | Run in headless daemon mode | start |
remi --install | Install as autostart service | service |
remi --resume [id] | Resume a previous Claude session | sessions |
remi --sessions | List stored sessions | sessions |
remi --uninstall | Remove autostart service | service |
Per-Command Help
Every subcommand supports --help to show its own usage, options, and examples:
remi ls --help
remi kill --help
remi attach --help
remi new --help
This shows subcommand-specific help instead of the global help page.
Global Options
Network / daemon
| Option | Description | Default |
|---|---|---|
--port PORT | WebSocket server port | 18765 (env: REMI_PORT) |
--host HOST | Connect to daemon at HOST (for ls, attach, new, recent, kill) | localhost |
--bind HOST | Bind address for the WebSocket server | 0.0.0.0 |
--local | Localhost-only mode (implies --bind localhost + --no-mdns) | |
--network | Use mDNS/VPN discovery when listing sessions across hosts | |
--no-mdns | Disable mDNS advertising | |
--no-relay | Disable signaling/relay adapter | |
--no-tofu | Reject unknown client keys (no trust-on-first-use) | |
--auth / --no-auth | Force authentication on / off | auto |
--signaling-url URL | Override signaling server URL | wss://remi-signaling.yooz.workers.dev/connect |
--permanent-code | Use a fixed connection code instead of rotating | |
--push-secret SECRET | APNS push auth secret (env: REMI_PUSH_SECRET) | |
--orphan-timeout SECS | Orphan session timeout in seconds (0 = disabled) | 300 |
Session / directory
| Option | Description | Default |
|---|---|---|
--dir PATH | Working directory for new session (mutually exclusive with --recent) | |
--recent | Pick from recent project directories (for new, recent) | |
--resume [id] | Resume a previous Claude session (id optional; picks latest when omitted) | |
--sessions [all|running|exited] | List sessions (defaults to running) | running |
--max-bullet-length N | Truncate message bullets (0 = disabled) | 500 |
--no-telegram | Disable Telegram adapter even if token is configured |
Auto-approve (LLM)
| Option | Description | Default |
|---|---|---|
--auto-approve | Enable LLM auto-approve | config: auto_approve.enabled |
--no-auto-approve | Disable auto-approve (overrides config) | |
--auto-approve-model MODEL | LLM model name | gemma4:e2b |
--auto-approve-provider PROVIDER | ollama, openrouter, or a custom URL | ollama |
--auto-approve-api-key KEY | API key (required for OpenRouter) | |
--auto-approve-allow STR | Substring allow pattern (repeatable; appends to config) | |
--auto-approve-deny STR | Substring deny pattern (repeatable; appends to config) | |
--auto-approve-instructions TEXT | Natural-language guidance for the LLM |
See the Auto-Approve guide for semantics.
Identity / authorization
| Option | Description |
|---|---|
--passphrase | Prompt for passphrase when generating or importing identity |
--encrypt | Re-encrypt an unencrypted identity in place |
--decrypt | Remove passphrase from an encrypted identity (keep same keys) |
--force | Overwrite existing identity (for keygen, import-key) |
--label TEXT | Label an authorized key (authorize) |
--remove FINGERPRINT | Remove an authorized key (authorize) |
--public-only | Export only the public key (export-key) |
Misc
| Option | Description |
|---|---|
--install / --uninstall | Install/remove as autostart service |
--daemon | Run in headless daemon mode |
--help, -h | Show help (global or per-command) |
--version, -v | Show version and exit |
Unrecognized flags are passed through to Claude Code. Use -- to separate Remi flags from Claude Code arguments explicitly.