Skip to main content

CLI Gateway

Canonical inventory

Full platform inventory: Capability inventory.

The CLI is the default interactive gateway when stdin is a TTY.

Starting

pnpm cli          # from source (tsx)
carina # after npm install -g carina-agent
carina --cli-only # disables web and Telegram for terminal-only use

Commands

Type these at the You: prompt:

CommandDescription
/helpShow all commands
/providerList available providers
/provider deepseekSwitch to DeepSeek
/provider anthropicSwitch to Claude
/provider openaiSwitch to OpenAI
/clearClear in-session memory (DB episodic memory remains)
/recallShow last 10 session turns
/recall 20Show last N turns
/skillsList saved skill documents with usage counts
/memoriesList episodic memories (requires memory store)
/memories delete <id>Delete a specific memory by UUID
exitQuit the process

/memories and /provider also work on Telegram and Web. /recall and /skills are CLI-only.

Streaming

Carina streams token-by-token to stdout. Tool use appears inline as status text during the response (for example [using web-search...]).

Tool confirmation

Destructive or dangerous tools prompt before execution:

Run this tool? (y/N):

Only y runs the tool; Enter or any other key cancels.

Session

The CLI uses a stable session id per machine (cli + local). Episodic memory and Scout events attach to this session id when configured.

Without memory

If Postgres is unreachable, the CLI still runs but logs Memory: unavailable (chat only) and /recall returns no turns.