think

Personal context manager for Claude Code. Stop repeating yourself.

What is this?

think manages your personal preferences, patterns, and memory for Claude Code. Instead of repeating "use bun not npm" or "be direct, skip the fluff" every session, configure it once and Claude remembers.

It also generates project-level context — file trees, code signatures, and knowledge base docs — so Claude deeply understands your codebase without you explaining it.

Install

npm install -g claude-think

Works with any package manager (npm, yarn, pnpm, bun). Requires Node.js 18+.

Quick Start

# First run launches setup wizard automatically
think

# Or run setup directly
think setup

# Generate project context (run from your project directory)
think context

# Start using Claude - your context is automatically loaded
claude

How it works

1. Your preferences live in ~/.think/profiles/<name>/ (markdown files)
2. think auto-syncs to ~/.claude/CLAUDE.md which Claude reads at session start
3. think context scans your project and writes to ~/.claude/projects/<path>/CLAUDE.md
4. Zero project pollution — everything lives in ~/.think and ~/.claude

Commands

| Command | Description | |---------|-------------| | think | Launch interactive TUI | | think setup | Interactive profile wizard (re-runnable) | | think switch <profile> | Switch profile + auto-sync | | think context | Generate project context for current directory | | think learn "..." | Add a learning + auto-sync | | think agents add | Create agent from template (interactive or --template <name>) | | think status | Show profile, tokens, project context status |

think context

Scans your project and generates a context file Claude reads automatically:

think context                    # Default 12k token budget
think context --budget 20000     # Larger budget
think context --dry-run          # Preview without writing

Output includes:

• Project overview (runtime, frameworks, tooling)
• Token-aware adaptive file tree
• Code map — AST-based signature extraction via tree-sitter
  • Supported languages: TypeScript, TSX, JavaScript, Python, Go, Rust, Java, C#, Ruby, PHP
• Key files (full source for important files)
• Knowledge base (from .think/knowledge/*.md)
• Auto-generated knowledge — architecture layers, conventions, hub files, and dependency graph inferred from imports and file structure (fills unused knowledge budget automatically)

Configure with .think.yaml in your project root (optional — works with zero config).

Profiles

Switch between different configurations for work, personal projects, or clients:

think switch work     # Switch profile (auto-syncs)

Press P in the TUI to manage profiles interactively (create, delete, switch). New profiles can be created with role-based defaults without leaving the TUI.

TUI

Run think to launch the fullscreen TUI:

| Key | Action | |-----|--------| | Tab | Switch sections | | 1-6 | Jump to section | | ↑↓ / jk | Navigate / scroll | | ←→ | Switch sub-tabs | | e | Edit in $EDITOR | | n | New item | | d | Delete item | | c | Duplicate | | r | Rename | | s | Sync CLAUDE.md | | p | Preview CLAUDE.md | | P | Switch profile | | / | Search all files | | ? | Help | | q | Quit |

What you can configure

• Profile — Identity, communication style, personality
• Preferences — Tools, patterns, anti-patterns
• Memory — Learnings that persist across sessions
• Skills — Custom skill definitions for Claude
• Agents — Context-aware subagent configurations (see below)
• Automation — Workflows and subagent rules

Context-Aware Agents

Agents can automatically inject your profile preferences, so you write compact agent definitions instead of 500-line generic prompts.

Frontmatter fields

---
name: Frontend Developer
model: sonnet          # haiku | sonnet | opus — used when spawning Task subagent
inject:                # auto-inject profile sections into the agent
  - tools
  - patterns
  - anti-patterns
tools:
  - Read
  - Write
  - Bash
---

When think syncs to CLAUDE.md, agents with model or inject get a 'Spawn as' instruction and your profile content inlined — Claude knows how to invoke them as Task subagents with the right model.

What gets generated

A minimal agent like this:

---
name: Code Reviewer
model: sonnet
inject:
  - patterns
  - anti-patterns
tools:
  - Read
  - Glob
  - Grep
---

Review code for correctness and clarity.
Flag issues by severity: blocking, suggestion, nit.

Produces this in CLAUDE.md (with your actual profile content injected):

### Code Reviewer

Model: sonnet
Tools: Read, Glob, Grep
Spawn as: Task subagent (model: sonnet) when the trigger conditions are met.

#### User Preferences: Patterns to Follow
- Write tests first (TDD)
- Small, atomic commits

#### User Preferences: Anti-Patterns to Avoid
- Don't over-engineer solutions
- Don't add features that weren't requested

Review code for correctness and clarity.
Flag issues by severity: blocking, suggestion, nit.

Without inject (classic agents)

Agents without model or inject render exactly as before — no breaking changes:

---
name: Simple Helper
description: Answers questions
tools:
  - Read
  - Grep
---

Built-in templates

Create agents from templates in the TUI (press n in the Agents tab) or CLI:

think agents add                        # Interactive template picker
think agents add --template frontend    # Direct creation
think agents add --template blank       # Empty agent file

| Template | Model | Injects | Purpose | |----------|-------|---------|---------| | frontend | sonnet | tools, patterns | Build UI components | | backend | sonnet | tools, patterns | Build APIs and services | | reviewer | sonnet | patterns, anti-patterns | Review code quality | | tester | haiku | tools, patterns | Write tests (TDD) | | blank | — | — | Empty agent file |

Example

After setup, Claude automatically knows:

## About the User

Name: Amit

Senior developer - experienced and autonomous

## How Claude Should Behave

- Be direct and minimal - no fluff, just answers and code
- Skip lengthy reasoning unless asked

## Tool Preferences

### Runtime & Package Manager
- Use Bun (not npm, pnpm, yarn)

### Languages
- TypeScript
- Rust

No more repeating yourself.

License

MIT