mindkit 🧠 - Forge your AI development mind

Install and sync your AI development configurations across Claude Code, Cursor, and OpenAI Codex with a single command.

Define your commands, agents, and templates once — deploy everywhere.

✨ Features

• 🔄 Multi-tool Sync — Claude Code, Cursor, and Codex support built-in
• 🎯 Interactive CLI — Beautiful TUI for selecting tools and components
• 📦 Template System — Customizable commands, agents, and doc templates
• 💾 Auto Backup — Never lose your configurations
• 🔀 Watch Mode — Real-time sync on file changes
• 🛠️ Path Placeholders — Tool-agnostic paths that work everywhere

🚀 Quick Start

Run instantly (no installation):

npx mindkit install

Install globally:

npm install -g mindkit

Via Homebrew:

brew tap viniciuscarvalho/mindkit
brew install mindkit

📖 Usage

Install configs to your AI tools

# Interactive mode - select tools and components
mindkit install

# Quick install to specific tools
mindkit install --tools claude,cursor

# Preview what would be installed
mindkit install --dry-run

Initialize in a project

mindkit init

Sync between tools

# One-time sync
mindkit sync --source claude --target cursor

# Watch mode - auto-sync on changes
mindkit sync --watch

Manage backups

mindkit backup create    # Create backup
mindkit backup list      # List backups
mindkit backup restore   # Restore from backup

List components

mindkit list            # All components
mindkit list commands   # Commands only
mindkit list agents     # Agents only
mindkit list tools      # Detected tools

🗺️ Tool Mapping

mindkit automatically translates configurations for each tool:

| Concept | Claude Code | Cursor | Codex | |---------|-------------|--------|-------| | Commands | ~/.claude/commands/*.md | .cursor/rules/*.mdc | ~/.codex/AGENTS.md | | Agents | ~/.claude/agents/*.md | Embedded in rules | Merged in AGENTS.md | | Project config | CLAUDE.md | .cursorrules | AGENTS.md |

📦 Built-in Templates

Commands

| Name | Description | |------|-------------| | create-prd | Generate Product Requirements Documents | | generate-spec | Create technical specifications from PRDs | | generate-tasks | Break down specs into implementable tasks |

Agents

| Name | Description | |------|-------------| | swift-expert | Senior Swift developer with SwiftUI expertise | | backend-developer | Backend engineer for APIs and microservices | | ui-designer | Visual designer for interfaces and design systems | | typescript-pro | TypeScript expert for full-stack development |

🔧 Template Placeholders

Templates use placeholders that resolve correctly for each tool:

Use template from {{DOCS}}/specs/prd-template.md
Output to {{PROJECT}}/docs/tasks/prd-{{feature}}/prd.md

| Placeholder | Description | |-------------|-------------| | {{DOCS}} | Documentation directory | | {{PROJECT}} | Project root | | {{HOME}} | User home directory | | {{CONFIG}} | Tool's global config |

📁 Custom Templates

Add your own templates in ~/.mindkit/templates/:

~/.mindkit/
├── templates/
│   ├── commands/
│   │   └── my-command.md
│   └── agents/
│       └── my-agent.md
└── registry.yaml

# ~/.mindkit/registry.yaml
version: 1
templates:
  - name: my-command
    source: commands/my-command.md
    type: commands
    targets:
      claude:
        path: ~/.claude/commands/my-command.md
      cursor:
        path: .cursor/rules/my-command.mdc

💻 Programmatic API

import { getAdapter, detectInstalledTools, getAllTemplates } from 'mindkit';

// Detect installed tools
const tools = await detectInstalledTools();
// Map { 'claude' => true, 'cursor' => true, 'codex' => false }

// Get adapter and install
const claude = getAdapter('claude');
const templates = await getAllTemplates();
await claude.install(templates.commands[0], content);

📋 Releases

See the CHANGELOG for a complete history of changes.

| Version | Date | Highlights | |---------|------|------------| | 1.0.2 | 2026-01-22 | Fix version detection and package.json handling | | 1.0.1 | 2026-01-20 | Improved tool detection via PATH | | 1.0.0 | 2026-01-19 | Initial release |

🤝 Contributing

git clone https://github.com/Viniciuscarvalho/mindkit.git
cd mindkit
npm install
npm run build
npm link  # Link for local testing

📄 License

MIT © Vinicius Carvalho