@thinkermd/cli

CLI for managing .thinker.md/ context files — structured documentation that helps AI assistants understand your codebase.

Installation

# npm
npm install -g @thinkermd/cli

# yarn
yarn global add @thinkermd/cli

# pnpm
pnpm add -g @thinkermd/cli

After installation, the tk command will be available globally.

Quick Start

# 1. Login to ThinkerMD
tk login

# 2. Trigger context generation for your repository
tk generate

# 3. Check generation status
tk status

Commands

tk login

Authenticate with ThinkerMD.

tk login                    # Interactive login (opens browser)
tk login --token <token>    # Use API token directly

tk logout

Remove saved authentication.

tk logout

tk status

Show status of your repository's context.

tk status

Displays:

• Repository info (name, branch, commit)
• Context generation status
• Last sync time

tk generate

Trigger context generation for your repository.

tk generate                 # Generate for current branch
tk generate --branch main   # Generate for specific branch
tk generate --wait          # Wait for completion

tk init

Create local .thinker.md/ structure (for manual editing).

tk init              # Initialize structure
tk init --force      # Reinitialize existing

tk validate

Verify .thinker.md/ structure.

tk validate          # Full validation
tk validate --quiet  # Only errors (for CI)

How It Works

1. Connect your repository on thinkermd.dev
2. ThinkerMD generates context files using AI
3. Context files help AI assistants understand your code better

The generated .thinker.md/ folder contains:

• CONTEXT.md files for each directory
• Project configuration and structure metadata

Requirements

• Node.js 18+
• Git repository

Development

# Clone and install
git clone https://github.com/thinkermd/cli.git
cd cli
bun install

# Run locally
bun run dev status

# Build
bun run build

# Type check
bun run typecheck

License

MIT