claude-init

Bootstrap your Claude Code workspace in 30 seconds.

One command generates a battle-tested CLAUDE.md, skills, agents, and MCP configs — all tailored to your stack. No copy-pasting from docs. No blank slate.

npx @karan-g-2003/claude-init

Why

Every time you start a new project with Claude Code, you're doing the same thing: writing a CLAUDE.md, hunting for the right skills, configuring MCP servers, setting up agent definitions.

claude-init does all of it in one command. Answer 5 questions. Get a complete workspace.

What gets generated

| File | What it is | |------|-----------| | CLAUDE.md | Your agent's memory — stack, conventions, rules, commands | | .claude/skills/ | Skills tailored to your stack (code review, TDD, debugging, API design…) | | .claude/agents/ | Pre-configured agents (code reviewer, planner, security reviewer) | | .claude/mcp.json | MCP server configs for your tools (GitHub, Supabase, Postgres, Vercel…) | | .cursor/rules/ | Cursor-compatible rules (if you picked Cursor) | | AGENTS.md | Codex-compatible config (if you picked Codex) |

Demo

npx @karan-g-2003/claude-init

  ██████╗██╗      █████╗ ██╗   ██╗██████╗ ███████╗
 ██╔════╝██║     ██╔══██╗██║   ██║██╔══██╗██╔════╝
 ██║     ██║     ███████║██║   ██║██║  ██║█████╗
 ██║     ██║     ██╔══██║██║   ██║██║  ██║██╔══╝
 ╚██████╗███████╗██║  ██║╚██████╔╝██████╔╝███████╗
  ╚═════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝

  ██╗███╗   ██╗██╗████████╗
  ██║████╗  ██║██║╚══██╔══╝
  ██║██╔██╗ ██║██║   ██║
  ██║██║╚██╗██║██║   ██║
  ██║██║ ╚████║██║   ██║
  ╚═╝╚═╝  ╚═══╝╚═╝   ╚═╝

  Bootstrap your AI workspace in 30 seconds.

  Let's set up your workspace.
  5 quick questions — then you're done.

  ────────────────────────────────────────────────

  What is your primary stack?
    1. Python          Django, FastAPI, ML, data science
    2. JavaScript / TypeScript  Node.js, React, Next.js
    3. Java            Spring Boot, microservices
    4. Full-Stack      Frontend + Backend combo
    5. Go              APIs, CLIs, systems
    6. Rust            Systems, WASM, CLI tools

  Enter number (1-6): 1

  What are you building?
    1. API / Backend service  REST, GraphQL, gRPC
    2. ML / AI project        models, pipelines, data
    ...

  ────────────────────────────────────────────────

  Generating your workspace...

  ✓ CLAUDE.md
  ✓ .claude/skills/code-review/SKILL.md
  ✓ .claude/skills/tdd-workflow/SKILL.md
  ✓ .claude/skills/python-patterns/SKILL.md
  ✓ .claude/skills/ml-workflow/SKILL.md
  ✓ .claude/skills/api-design/SKILL.md
  ✓ .claude/agents/code-reviewer.md
  ✓ .claude/agents/planner.md
  ✓ .claude/agents/security-reviewer.md
  ✓ .claude/mcp.json

  Done! Your workspace is ready.

  Next steps:
    1. Open Claude Code in this directory
    2. Read CLAUDE.md — it's your agent's memory
    3. Try a skill: "Use @code-review to review my changes"

  Star the repo if this saved you time:
  https://github.com/Karan-g-2003/claude-init

Supported stacks

| Stack | Skills generated | |-------|-----------------| | Python | python-patterns, tdd-workflow, code-review, debugging | | TypeScript / JS | typescript-patterns, tdd-workflow, code-review, frontend-patterns | | Java | java-patterns, tdd-workflow, code-review | | Go | go-patterns, tdd-workflow, code-review | | Rust | rust-patterns, tdd-workflow, code-review | | Full-Stack | frontend-patterns + backend patterns |

Supported project types

| Type | Extra skills | |------|-------------| | API / Backend | api-design | | ML / AI | ml-workflow | | Frontend | frontend-patterns | | CLI tool | cli-patterns | | Full-stack | frontend + backend | | Library | library-conventions |

Supported tools (MCP configs)

• GitHub
• Supabase
• PostgreSQL
• Vercel
• Docker (rules only)

Supported AI tools

| Tool | What gets generated | |------|-------------------| | Claude Code | .claude/ directory (CLAUDE.md, skills, agents, MCP) | | Cursor | .cursor/rules/ | | Codex | AGENTS.md | | All | Everything above |

Requirements

• Node.js 18+
• No installation needed — just npx

Contributing

Skills and templates live in src/generators/. Adding support for a new stack or tool is straightforward:

1. Add stack config to src/generators/skills.js
2. Add CLAUDE.md guide to src/generators/claude-md.js
3. Open a PR

See CONTRIBUTING.md for details.

The missing piece

claude-init is the missing piece: instead of manually copying configs from those repos, you get exactly what you need for your project in one command.

License

MIT — use it, fork it, ship it.