Claude Subconscious

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, 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 subconscious 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 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.

Installation

Install from GitHub:

Updating

Install from Source

Clone the repository:

Enable the plugin (from inside the cloned directory):

Or enable globally for all projects:

If running from a different directory, use the full path to the cloned repo.

Linux: tmpfs…