ccinit

[](https://github.com/zzhiyuann/ccinit/actions/workflows/ci.yml) [](https://www.npmjs.com/package/ccinit) [](LICENSE)

> Auto-generate Claude Code configuration from your codebase.

One command. Zero config. Your project is ready for Claude Code.

[Landing page](https://zzhiyuann.github.io/ccinit/) | [npm](https://www.npmjs.com/package/ccinit)

npx ccinit

That's it. ccinit scans your project and generates:

• CLAUDE.md -- Build, test, lint commands and project conventions
• .claude/settings.local.json -- MCP server recommendations (Git, filesystem, Context7, and more)
• .claude/commands/ -- Project-specific slash commands (test, dev, review, + framework-specific)

| Signal | Examples | |--------|---------| | Languages | TypeScript, Python, Rust, Go, Java, Ruby, C#, Swift | | Frameworks | Next.js, React, FastAPI, Django, Axum, Gin, Express, NestJS | | Build systems | npm/yarn/pnpm, cargo, pip/poetry/uv, go, make | | Test runners | vitest, jest, pytest, cargo test, go test | | Linters | ESLint, Prettier, Biome, ruff, black, clippy, golangci-lint | | Dev servers | Detected from package.json scripts, uvicorn, flask run | | Monorepos | npm/yarn/pnpm workspaces, Lerna, Cargo workspaces |

For a Next.js project, ccinit generates a CLAUDE.md like this:

# my-app

## Build & Run
- `npm run build`

Dev server:
- `npm run dev`

## Test
- `npm run test`
- `npm run test path/to/file.test.ts` -- run a single test file

## Lint & Format
- `npm run lint`

## Project Structure
- `src/` -- Source code
- `app/` -- Application entry / pages
- `components/` -- UI components
- `public/` -- Static assets
- `tests/` -- Tests

## Tech Stack
- Language: TypeScript
- Framework: Next.js, Rea