The First 15 Minutes

This guide gets you from a fresh installation to your first "warm" session.

1. Create an Account

Register for a Recalletta account. This can also be done via the web dashboard at recalletta.ai.

recalletta register

2. Initialize

Run the one-time setup command. This authenticates, tests API connectivity, and installs hooks for all detected agent clients (Claude Code, Gemini CLI, Codex CLI).

recalletta init

That is it. No further manual setup is needed. The hooks handle everything from here.

3. Your First Session

Open a project directory and start any supported agent client.

cd my-project
claude    # or gemini, or codex

Work normally for a few minutes. When the session ends, the transcript uploads in the background automatically.

4. Verifying the Capture

Search for a keyword from the session that just closed. Agents do this automatically, but it can also be done manually or via the web dashboard at recalletta.ai.

recalletta "refactor"

If the session ID appears in the results, the system is working.

5. Setting Your First "Gotcha"

Think of a project convention that agents always need to know. Add it to the Knowledge Base and mark it as important so it is injected into every future session.

recalletta kb set gotchas/style -t "Coding Style" -b "Always use async/await. No callbacks." -i

The -i flag is critical — it marks this entry as important. Important entries are automatically injected into every agent session for this project. Keep important entries compact: every important entry consumes agent context window.

6. The "Warm" Start

Now, start a new agent session in the same project.

claude    # or gemini, or codex

The agent starts the session with additional context already injected. Ask: "What is our coding style here?"

The agent will respond with "Always use async/await. No callbacks," because Recalletta injected that knowledge base entry before any prompt was typed.

Next Steps