# Contributing to @indemn/cli

## Getting Started

```bash
git clone <repo-url>
cd indemn-cli
npm install
npm run build
```

## Development

```bash
npm run dev          # watch mode
npm run build        # compile TypeScript
npm test             # run tests
```

Test your local build without installing globally:

```bash
node dist/cli/index.js <command>
```

## Project Structure

```
src/
  cli/           # CLI commands (Commander.js)
  sdk/           # API client and SDK methods
  mcp/           # MCP server (tools for Claude AI, Gemini, etc.)
  report/        # PDF report generation (React-PDF)
skills/          # Claude Code skills (markdown)
  agent-builder/ # Agent creation and configuration workflow
  evaluations/   # Evaluation lifecycle workflow
```

## Making Changes

1. Create a branch from `main`
2. Make your changes
3. `npm run build` — must compile cleanly
4. Test against dev: `indemn login --env dev`
5. Open a PR with a clear description of what and why

## Skills

The `skills/` directory contains Claude Code skills that teach AI agents how to use the CLI. If you add or change a CLI command, update the relevant skill. These are the primary documentation that users interact with.

## Issues

Open GitHub issues for bugs, feature requests, or questions. Include:
- What you tried
- What happened
- What you expected

## Publishing

CI/CD handles publishing to npm on merge to main (once set up). Do not publish manually unless necessary.