Claude Subconscious

[!IMPORTANT] Claude Subconscious is demo app built using the Letta Code SDK, and is not intended to be used in production.

If you want to use a coding agent that runs background subconscious agents, use [**Letta Code**](https://github.com/letta-ai/letta-code), which is also fully open source.

Install the Letta Code CLI with `npm install -g @letta-ai/letta-code`, then use `letta` to launch.

Claude Subconscious

A background agent that whispers to Claude Code. A subconcious agent that watches your sessions, reads your files, builds up memory over time, and whispers guidance back.


What Is This?

Claude Code forgets everything between sessions. Claude Subconscious is a second agent running underneath — watching, learning, and whispering back:

• Watches every Claude Code session transcript
• Reads your codebase — explores files with Read, Grep, and Glob while processing transcripts
• Remembers across sessions, projects, and time
• Whispers guidance — surfaces context, patterns, and reminders before each prompt
• Never blocks — runs in the background via the Letta Code SDK

Not just a memory layer — a background agent with real tool access that gets smarter the more you use it.

Using Letta's [Conversations](https://docs.letta.com/guides/agents/conversations/) feature, a single agent can serve multiple Claude Code sessions in parallel with shared memory across all of them.

How It Works

After each response, the transcript is sent to a Letta agent via the Letta Code SDK. The agent reads files, searches the web, updates its memory — then whispers back before the next prompt. Nothing is written to CLAUDE.md.

┌─────────────┐          ┌──────────────────────────┐
│ Claude Code │◄────────►│ Letta Agent (background)  │
└─────────────┘          │                          │
       │                 │  Tools: Read, Grep, Glob │
       │