Skip to content
/ super-claude-kit Public

Transform Claude Code from stateless to stateful. Persistent context memory system with cross-session persistence, token-efficient storage, and zero dependencies.

dev.to/arpitnath/fixing-claude-codes-amnesia-5g9f
8 stars 1 fork Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

arpitnath/super-claude-kit

BranchesTags

Repository files navigation

Super Claude Kit

Super Claude Kit

License: MIT Claude Code Version

Super Claude Kit adds persistent memory to Claude Code.

A persistence layer for Claude Code.
Files, tasks, discoveries — all restored instantly.

curl -fsSL https://raw.githubusercontent.com/arpitnath/super-claude-kit/master/install | bash

Super Claude Kit

Quickstart

Installing Super Claude Kit

Run the one-line installer:

curl -fsSL https://raw.githubusercontent.com/arpitnath/super-claude-kit/master/install | bash

That's it! Restart Claude Code and you'll see the context capsule on every session.

Manual installation (advanced) 
# Clone the repository
git clone https://github.com/arpitnath/super-claude-kit.git
cd super-claude-kit

# Run the installer
bash install

The installer will:

  • Install hooks to .claude/hooks/
  • Build Go tools (dependency-scanner, progressive-reader)
  • Configure ~/.claude/settings.local.json
  • Auto-install Go 1.23+ if not present

What you get immediately

Session Resume

After installation, Claude Code will:

  • 🧠 Remember files you've accessed (no re-reads)
  • 📦 Restore context between sessions (up to 24 hours)
  • ✅ Track tasks across restarts
  • 🔍 Log discoveries as you work
  • 🔗 Understand dependencies in your codebase

How it works

Super Claude Kit uses hooks (SessionStart, UserPromptSubmit) to:

  1. Capture context as you work (file access, tasks, git state)
  2. Store in capsule (.claude/capsule.json)
  3. Restore on restart (automatic, zero manual input)

No configuration needed. It just works.

Features

🧠 Persistent Memory

Stop wasting tokens on re-reads.

Vanilla Claude Code re-reads files on every question. Super Claude Kit tracks what's been read and references from memory.

📦 Context Capsule

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📦 CONTEXT CAPSULE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🌿 Git State:
   Branch: feat/oauth (2 commits ahead)

📁 Files in Context:
   • auth/OAuthController.ts (read 2h ago)
   • config/google.ts (edited 1h ago)
   • routes/auth.ts (read 2h ago)

🔍 Discoveries:
   • Google OAuth requires state parameter
   • Token stored in httpOnly cookie

✅ Current Tasks:
   ⚡ Implementing OAuth callback handler
   ✓ Controller setup complete
   ✓ Google provider config added

💡 Previous session: 2 hours ago
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

See exactly what Claude remembers. Every session start shows your capsule with:

  • Git branch and commit status
  • Files accessed with timestamps
  • Discoveries logged during work
  • Active and completed tasks
  • Time since last session

The capsule uses TOON format for 52% token reduction compared to JSON.

🔗 Dependency Intelligence

Dependency Graph

Know what breaks before you break it.

Built-in dependency scanner analyzes your codebase:

Available Commands

# Query what files import this file
.claude/tools/query-deps/query-deps.sh src/auth.ts

# Analyze impact of changing a file
.claude/tools/impact-analysis/impact-analysis.sh src/database.ts

# Find circular dependencies
.claude/tools/find-circular/find-circular.sh

# Identify unused files
.claude/tools/find-dead-code/find-dead-code.sh

Performance

  • 1,000 files scanned in <5 seconds
  • 10,000 files scanned in <30 seconds
  • Supports TypeScript, JavaScript, Python, Go

🛠️ Built-in Tools

Progressive Reader

Read large files (>50KB) in semantic chunks using tree-sitter AST parsing.

# Read first chunk of a large file
progressive-reader --path src/large-file.ts

# List all chunks without content (preview)
progressive-reader --list --path src/large-file.ts

# Read specific chunk by index
progressive-reader --chunk 2 --path src/large-file.ts

# Continue from previous read (uses TOON token)
progressive-reader --continue-file /tmp/continue.toon

Supported languages: TypeScript, JavaScript, Python, Go

When to use:

  • Files > 50KB that would consume too much context
  • Reading sub-agent outputs progressively
  • Large codebase exploration with minimal context usage

Dependency Scanner

Analyzes code structure and relationships using tree-sitter AST parsing.

# Build dependency graph
~/.claude/bin/dependency-scanner --path . --output .claude/dep-graph.toon

Features:

  • Import/export tracking
  • Circular dependency detection (Tarjan's algorithm)
  • Impact analysis
  • Dead code identification

🤖 Specialized Sub-Agents

Production-safe, read-only agents for common development tasks:

  • architecture-explorer - Understand service boundaries and data flows
  • database-navigator - Explore schemas, migrations, and relationships
  • agent-developer - Build and debug AI agents with MCP integration
  • github-issue-tracker - Create well-formatted issues from discoveries

All agents are sandboxed and require explicit permission for write operations.

Docs & Guides

Requirements

  • Claude Code (Desktop CLI or VSCode extension)
  • macOS or Linux (Windows WSL supported)
  • Go 1.23+ (auto-installed if not present)
  • Bash 4.0+

Optional (for enhanced features):

  • Git - Provides branch tracking and git-aware change detection
    • Without git: Uses file modification time for change detection
    • All core features work without git

Verification

After installation, verify everything works:

# Run comprehensive tests
bash .claude/scripts/test-super-claude.sh

# View current stats
bash .claude/scripts/show-stats.sh

# Check installed tools
~/.claude/bin/dependency-scanner --version
~/.claude/bin/progressive-reader --version

Expected output:

✅ Super Claude Kit v1.0.0
✅ dependency-scanner v1.0.0
✅ progressive-reader v1.0.0
✅ All hooks configured
✅ All tests passed

Updating

Check for Updates

bash .claude/scripts/update-super-claude.sh

Development Mode

Install latest development version:

bash .claude/scripts/update-super-claude.sh --dev

Configuration

Settings Location

.claude/settings.local.json

{
  "permissions": {
    "allow": [
      "Bash(git add:*)",
      "Bash(git commit:*)",
      "Bash(~/.claude/bin/dependency-scanner:*)",
      "Bash(progressive-reader:*)"
    ]
  },
  "hooks": {
    "SessionStart": ["bash .claude/hooks/session-start.sh"],
    "UserPromptSubmit": ["bash .claude/hooks/pre-task-analysis.sh"]
  }
}

Customization

  • Custom hooks - Add to hooks/ directory
  • Custom tools - Add to tools/ directory
  • Specialized agents - Add to agents/ directory
  • Reusable skills - Add to skills/ directory

See Configuration Guide for details.

Troubleshooting

Hooks not executing

# Verify settings
cat .claude/settings.local.json

# Test hook manually
bash .claude/hooks/session-start.sh

Capsule not updating

# Force refresh
rm .claude/last_refresh_state.txt

# Check logs
tail -f .claude/hooks.log

Dependency graph not building

# Verify scanner installation
ls -la ~/.claude/bin/dependency-scanner

# Rebuild manually
~/.claude/bin/dependency-scanner --path . --output .claude/dep-graph.toon

Debug Mode

Enable verbose logging:

CLAUDE_DEBUG_HOOKS=true claude

For more issues, see FAQ or open an issue.

Performance

Benchmarks

Operation Performance Details
Context Refresh <100ms Smart change detection
Graph Building 1000 files in <5s Parallel parsing
Large Project 10000 files in <30s Incremental updates
Token Efficiency ~52% reduction TOON vs JSON and avoids re-reads

Uninstall

cd super-claude-kit
bash uninstall

Removes hooks, tools, and configuration. Your .claude/ data logs are preserved in .claude/backup/.

Contributing

Contributions are welcome! Please follow these guidelines:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit changes with clear messages
  4. Push to branch (git push origin feature/amazing-feature)
  5. Open a pull request

See CONTRIBUTING.md for detailed guidelines.

Development Setup

git clone https://github.com/arpitnath/super-claude-kit.git
cd super-claude-kit
bash install

Running Tests

bash .claude/scripts/test-super-claude.sh

License

This repository is licensed under the MIT License.

Copyright (c) 2025 Arpit Nath

Acknowledgments

Star History

If you found Super Claude Kit useful, please star the repo! ⭐

Star History Chart

Never re-explain yourself to Claude. Ever.

Report Bug · Request Feature · GitHub · LinkedIn

About

Transform Claude Code from stateless to stateful. Persistent context memory system with cross-session persistence, token-efficient storage, and zero dependencies.

dev.to/arpitnath/fixing-claude-codes-amnesia-5g9f

Topics

hooks developer-tools claude ai-assistant claude-ai anthropic-claude llm-tools claude-code claude-plugins

Resources

Readme
Activity

Stars

8 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases 3

v1.1.0 Latest
Nov 30, 2025
+ 2 releases

Packages

No packages published

Contributors 2

Languages