claude-subconscious
Give Claude Code a subconscious
Discover how the Claude Subconscious plugin seamlessly handles agent ID changes and conversation format migrations using a persistent JSON mapping. It automatically detects switches and upgrades data without user intervention.
SDK_TOOLS_BLOCKED in Letta SDK Sessions: Why Interactive Tools Are RestrictedUnderstand SDK_TOOLS_BLOCKED in Letta SDK sessions. Learn why interactive tools like AskUserQuestion are restricted to ensure deterministic, non-interactive execution and prevent hangs.
How the SDK Worker Processes Transcripts in the Background in letta-ai/claude-subconsciousDiscover how the letta-ai/claude-subconscious SDK worker in send_worker_sdk.ts efficiently processes transcripts in the background. Learn about its non-blocking approach to sending messages and updating sync states.
Claude‑Code Transcript Processing Flow: Extracting Messages, Thinking Blocks, and Tool UsageDiscover the Claude-Code transcript processing flow. Extract user messages, thinking blocks, and tool usage from JSONL files. Format data into XML payloads for agent consumption with letta-ai/claude-subconscious.
How to Configure a Different Agent Per Project Using LETTA_AGENT_ID with direnvEasily configure a different Letta agent per project using LETTA_AGENT_ID and direnv. Automatically set environment variables by loading .envrc files to manage multiple agents in your projects.
Session State Caching Mechanism and lastProcessedIndex in Claude SubconsciousDiscover how Claude Subconscious uses session state caching with a durable JSON file to store lastProcessedIndex, preventing duplicate transcript messages across restarts.
How the Claude-Subconscious Plugin Handles Cleaning Up Legacy <letta> Content from CLAUDE.mdLearn how the Claude-Subconscious plugin automatically cleans legacy <letta> content from CLAUDE.md. Prevent duplicate data with the cleanLettaFromClaudeMd utility. Explore the script for details.
How to Debug Hook Failures Using Log Files in $TMPDIR/letta-claude-sync-$UIDDebug hook failures in letta-claude-sync-$UID log files. Discover specific error details for each hook in dedicated session and message log files to quickly resolve issues.
Letta REST API vs Letta Code SDK: 8 Key Differences in the Claude-Subconscious PluginCompare Letta REST API vs SDK for Claude-Subconscious plugin. Discover differences in manual HTTP handling versus high-level session abstraction with real-time streaming and automatic auth.
How Claude Subconscious Achieves Two-Way Communication with Claude CodeDiscover how Claude Subconscious achieves two-way communication with Claude Code using three hook scripts for persistent conversations, XML transcript updates, and agent response injection.
Windows SilentLauncher in Claude Subconscious: How It Spawns Background Workers Without Console FlashDiscover the Windows SilentLauncher in Claude Subconscious. Learn how this C# executable spawns Node.js background workers invisibly, avoiding the console flash on Windows 11. Optimize your workflows now.
How to Use LETTA_HOME to Consolidate Claude-Subconscious State Across Multiple ProjectsConsolidate Claude-Subconscious state across projects using LETTA_HOME. This environment variable enables memory sharing and a unified agent ID, simplifying multi-project agent management.
Have a question about this repo?
These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:
curl -s "https://instagit.com/install.md" 
Maintain an open-source project? Get it listed too →