npm package: @kleros-ai/claude-setup
Description: Interactive CLI to setup Claude Code configuration for your project
Author: Kleros-AI
Latest version: 2.0.0

# @kleros-ai/claude-setup

Interactive CLI wizard to setup Claude Code configuration for your project.

## Installation & Usage

```bash
# Run directly with npx (recommended)
npx @kleros-ai/claude-setup

# Or install globally
npm install -g @kleros-ai/claude-setup
claude-setup
```

## What It Does

This CLI wizard asks you questions about your project and generates a complete Claude Code configuration:

```
🤖 Kleros-AI Claude Config Setup Wizard
=======================================

? Proje adı nedir? my-project
? Proje açıklaması: My awesome project
? Proje tipi nedir? Next.js Frontend
? Tech stack seçin: TypeScript, Tailwind CSS
? Hangi MCP server'ları kullanacaksınız? PostgreSQL, GitHub
? Ekip büyüklüğü? Small team (2-5)
? CI/CD platformu? GitHub Actions
? Ek agent'lar eklemek ister misiniz? security-auditor
? Hangi hook'ları aktifleştirmek istersiniz? validate-secrets
? Hangi custom command'ları eklemek istersiniz? /test, /pr, /review

✅ Setup Complete!
   Oluşturulan dosyalar:
   ├── .claude/settings.json
   ├── .claude/agents/ (4 agents)
   ├── .claude/commands/ (3 commands)
   ├── .claude/hooks/ (1 hooks)
   ├── .claude/mcp-servers/ (2 configs)
   └── CLAUDE.md
```

## Generated Structure

```
your-project/
├── .claude/
│   ├── settings.json          # Permissions & hook configs
│   ├── agents/                # AI agents for different tasks
│   │   ├── ui-developer.md
│   │   ├── test-runner.md
│   │   └── ...
│   ├── commands/              # Custom slash commands
│   │   ├── test.md
│   │   ├── pr.md
│   │   └── ...
│   ├── hooks/                 # Auto-trigger scripts
│   │   └── validate-secrets.sh
│   ├── mcp-servers/           # MCP configurations
│   │   ├── postgres.json
│   │   └── github.json
│   └── memory/                # Project knowledge
│       ├── project-facts.md
│       └── conventions.md
└── CLAUDE.md                  # Main project instructions
```

## Project Types

| Type | Default Agents |
|------|----------------|
| Next.js Frontend | ui-developer, test-runner, seo-accessibility |
| Python/FastAPI Backend | backend-developer, test-runner, security-auditor |
| Full-stack | ui-developer, backend-developer, test-runner, devops |
| React Native | ui-developer, test-runner |
| Node.js Library | backend-developer, test-runner, documentation-writer |
| Go Backend | backend-developer, test-runner, devops |
| Django Backend | backend-developer, test-runner, security-auditor |

## Available Agents

| Agent | Purpose | Model |
|-------|---------|-------|
| ui-developer | Frontend/React development | inherit |
| backend-developer | API/server-side development | inherit |
| code-reviewer | Code quality analysis | sonnet |
| test-runner | Test execution | haiku |
| debugger | Bug investigation | inherit |
| security-auditor | Vulnerability detection | sonnet |
| devops | CI/CD and infrastructure | inherit |
| git-workflow | Git operations | haiku |
| documentation-writer | Documentation | inherit |
| seo-accessibility | SEO and a11y | sonnet |

## Available Hooks

| Hook | Trigger | Action |
|------|---------|--------|
| pre-edit-backup | Before Edit | Creates backup, warns on main branch |
| post-edit-format | After Edit | Auto-formats code |
| validate-secrets | Before Bash | Blocks commands with secrets |

## Available Commands

| Command | Description |
|---------|-------------|
| /deploy | Production deployment |
| /test | Run tests |
| /pr | Create pull request |
| /ticket | Start from ticket |
| /onboard | Analyze codebase |
| /refactor | Safe refactoring |
| /release | Release workflow |
| /review | Code review |

## MCP Servers

| Server | Purpose |
|--------|---------|
| PostgreSQL | Database queries |
| GitHub | PR/Issue management |
| Slack | Team messaging |
| Filesystem | Extended file access |
| Memory | Knowledge persistence |

## Development

```bash
# Clone repo
git clone https://github.com/Kleros-AI/claude-config-template.git
cd claude-config-template/cli

# Install dependencies
npm install

# Run locally
npm start
```

## License

MIT - Kleros-AI / DELIVERY ONE TEKNOLOJİ A.Ş.