claude-subconscious
Give Claude Code a subconscious
Claude Subconscious is a Claude Code plugin that adds persistent memory across sessions by running a secondary Letta agent in the background. The plugin watches Claude Code transcripts, reads your codebase using file tools, builds contextual memory over time, and surfaces relevant guidance before each prompt. It enables cross-session continuity, learned user preferences, and proactive codebase awareness without blocking the main coding workflow.
Key Features
Use Cases
- 01Maintain persistent project context and architecture knowledge across multiple coding sessions
- 02Learn and apply user coding preferences like style conventions, tool choices, and communication patterns
- 03Surface relevant patterns and reminders when you revisit similar problems across sessions
- 04Enable the background agent to proactively read relevant files and research topics while you code
- 05Track unfinished work and pending TODOs across sessions without manual note-taking
- 06Detect workflow patterns like repeated debugging sessions to suggest stepping back
Related Plugins
View moreandrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
claude-mem
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Understand-Anything
Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
rtk
CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies
claude-subconscious — FAQ
What is Claude Subconscious?+
Claude Subconscious is a Claude Code plugin that runs a secondary Letta agent in the background to provide persistent memory across sessions. The background agent watches transcripts, reads your codebase, and whispers contextual guidance back to Claude Code.
How do I install the Claude Subconscious plugin?+
Inside Claude Code, run '/plugin marketplace add letta-ai/claude-subconscious' followed by '/plugin install claude-subconscious@claude-subconscious'. You'll need to set the LETTA_API_KEY environment variable with your API key from app.letta.com.
Do I need a Letta API key?+
Yes, you need a LETTA_API_KEY from app.letta.com to use this plugin. The plugin creates and manages a Letta agent that runs in the background, which requires authentication with the Letta API.
Which AI clients does this work with?+
This plugin is specifically designed for Claude Code and uses Claude Code's plugin hooks (SessionStart, UserPromptSubmit, PreToolUse, Stop). It does not work with other AI clients.
Is Claude Subconscious free to use?+
The plugin itself is open source (MIT license), but it requires a Letta account. The default bundled agent uses zai/glm-5 which is free on Letta Cloud, though you can configure it to use other models that may incur costs.
Can I use different agents for different projects?+
Yes, by default all projects share one global agent brain, but you can set LETTA_AGENT_ID per-project using environment variables or direnv to use different agents for different repositories.
How do I install claude-subconscious?+
Open the source repository on GitHub and follow its README. claude-subconscious is a plugin — MCP Agents Market links you directly to the official repo.
Is claude-subconscious free?+
claude-subconscious is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.