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
architect	Software architecture specialist for system design
backend-developer	Backend engineer for APIs and microservices
code-reviewer	Expert code review for quality, security, and maintainability
frontend-developer	Modern frontend specialist with React/Vue expertise
mobile-developer	Cross-platform mobile development specialist
swift-expert	Senior Swift developer with SwiftUI expertise
swift-reviewer	Code reviewer for Swift/SwiftUI code quality
swiftui-specialist	SwiftUI expert for complex UI implementation
typescript-pro	TypeScript expert for full-stack development
ui-designer	Visual designer for interfaces and design systems

---

🔧 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.1.0	2026-02-04	New agents and enhanced templates
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

---

_{Built with 🧠 for the AI-assisted development community}