**claude-cognitive**

Claude Cognitive

Working memory for Claude Code — persistent context and multi-instance coordination

[](https://opensource.org/licenses/MIT) []()

---

The Problem

Claude Code is powerful but stateless. Every new instance:

• Rediscovers your codebase from scratch
• Hallucinates integrations that don't exist
• Repeats debugging you already tried
• Burns tokens re-reading unchanged files

With large codebases (50k+ lines), this becomes painful fast.

---

The Solution

**Claude Cognitive** gives Claude Code working memory through two complementary systems:

1. Context Router

**Attention-based file injection** with cognitive dynamics:

• HOT (>0.8): Full file injection - active development
• WARM (0.25-0.8): Headers only - background awareness
• COLD (<0.25): Evicted from context

Files **decay** when not mentioned, **activate** on keywords, and **co-activate** with related files.

2. Pool Coordinator

**Multi-instance state sharing** for long-running sessions:

• Automatic mode: Detects completions/blockers from conversation (every 5min)
• Manual mode: Explicit pool blocks for critical coordination
• Works with persistent sessions (days/weeks), not just short bursts

---

Results

**Token Savings:**

• Cold start: 79% (120K → 25K chars)
• Warm context: 70% (80K → 24K chars)
• Focused work: 75% (60K → 15K chars)

**Average: 64-95% depending on codebase size and work pattern.**

**Developer Experience:**

• ✅ New instances productive in first message
• ✅ Zero hallucinated imports/integrations
• ✅ No duplicate work across 8+ concurrent instances
• ✅ Persistent memory across days-long sessions

**Validated on:**

• 1+ million line production codebase (3,200+ Python modules)
• 4-node distributed architecture
• 8 concurrent Claude Code instances
• Multi-day persistent sessions

---

Quick Start

1. Install Scripts

# Clone to your home directory
cd ~

...