claude-init

Bootstrap your Claude Code workspace in 30 seconds.

npx @karan-g-2003/claude-init

Answer 5 questions. Get a complete AI workspace. No copy-pasting from docs. No blank slate.

---

What is this?

Every time you start a new project with Claude Code, you do the same thing manually — write a CLAUDE.md, hunt for skills, configure MCP servers, set up agents.

claude-init does all of it in one command, tailored to your exact stack.

---

What gets generated

File	What it is
CLAUDE.md	Your agent's memory — stack, conventions, rules, commands
.claude/skills/	Skills for your stack (code review, TDD, debugging, API design…)
.claude/agents/	Pre-built agents (code reviewer, planner, security reviewer)
.claude/mcp.json	MCP server configs for your tools (GitHub, AWS, Sentry, Linear…)
.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.
  ────────────────────────────────────────────────

  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

  Which tools do you use? (pick all that apply)
    1. GitHub               version control + CI/CD
    2. Docker               containerization
    3. PostgreSQL           production database
    4. AWS                  cloud infrastructure
    5. Kubernetes           container orchestration
    6. Linear               issue tracking
    7. Sentry               error monitoring
    8. Supabase             database + auth (startups)
    9. Vercel               frontend deployment
   10. Google Stitch        AI UI design → code (free)

  ────────────────────────────────────────────────
  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.

---

Supported stacks

Stack	Skills generated
Python	python-patterns tdd-workflow code-review debugging-strategy
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 + backend patterns combined

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 MCP tools

Tool	What it connects
GitHub	Repos, PRs, issues
AWS	Cloud infrastructure
Kubernetes	Container orchestration
Linear	Issue tracking + sprints
Sentry	Error monitoring + alerts
PostgreSQL	Direct DB queries
Supabase	Database + auth
Vercel	Deployments
Google Stitch	AI UI design → code (free)

Supported AI tools

Tool	What gets generated
Claude Code	.claude/ — CLAUDE.md, skills, agents, MCP config
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.

---

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.

---

Built by Karan · Star it if it saves you time ⭐