CLI Overview
Recalletta is a persistent memory system for AI coding agents, packaged as a single binary. Every feature is a subcommand. Most commands are invoked by agents automatically; users primarily interact via recalletta init (one-time setup), recalletta login (re-authentication), and the web dashboard at recalletta.ai.
recalletta v0.8.0 - AI persistent memory https://recalletta.ai
Global Options
Every subcommand accepts these flags:
| Flag | Purpose |
|---|---|
--api-url <URL> |
Override the API endpoint |
--api-key <KEY> |
Override the API key |
--debug |
Enable debug logging |
-q, --quiet |
Suppress non-essential output |
-j, --json |
Output as JSON |
--color <MODE> |
Color output: auto, always, never |
Command Groups
| Group | What it does |
|---|---|
| Sessions | Search, load, inspect, delete, upload sessions |
| Knowledge Base | Read, write, search, version KB entries |
| Projects | Create, list, rename, delete KB projects; pin directories |
| Hook & Setup | Install hooks, first-time setup, check status |
| Monitor & Start | Background session capture for Codex (and Gemini fallback) |
| Crew | Multi-agent orchestration |
| Attractor | Pipeline engine (DOT-based workflows) |
| Repo | Local FTS5 code search |
| Account | Login, register, API keys, settings |
The Default Command: Search
When recalletta is run with a plain string argument, it searches sessions:
$ recalletta "auth bug"
If the argument is an 8+ character hex string, it loads that session by ID:
$ recalletta 82bbfb7c
Special shortcuts:
$ recalletta last # Load the most recent session
$ recalletta --last # Same thing
$ recalletta --when 7d # Sessions from the last 7 days
$ recalletta --when today # Today's sessions
Date Filtering (--when)
The --when flag works on the default search command. It accepts:
| Format | Example | Meaning |
|---|---|---|
| Shortcuts | today, yesterday |
Calendar days |
| Relative | 7d, 2w, 1m, 1y |
Days, weeks, months, years ago |
| Exact date | 2024-01-15 |
That specific day |
| Range | 2024-01-01..2024-01-31 |
Between two dates |
| Open range | 2024-01-01.. |
From that date onward |
| Open range | ..2024-12-31 |
Up to that date |
Output Limits
| Flag | Default | Purpose |
|---|---|---|
-n, --limit <N> |
50 (or 100k with --when) |
Max results |
-s, --size <CHARS> |
unlimited | Truncate session body to N chars |
--full |
off | Include full body in search results |
Disambiguation
Some command names overlap with search terms. Use -- to force search mode:
$ recalletta -- auth # Search for 'auth' (not run auth command)
$ recalletta -- login # Search for 'login' (not run login command)