npm package: @karan-g-2003/claude-init
Description: Bootstrap your Claude Code workspace in 30 seconds. CLAUDE.md, skills, agents, MCP configs — all tailored to your stack.
Author: Karan
Latest version: 1.2.1

# 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.

```bash
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](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.

---

<p align="center">
  Built by <a href="https://github.com/Karan-g-2003">Karan</a> · Star it if it saves you time ⭐
</p>