# 🐉 AI Monsters

Your coding sessions with Claude evolve unique digital creatures. Every token spent shapes a monster only you can create.

## Install

```bash
npm install -g aimonsters
aimonsters init
```

That's it. Two commands. Every Claude Code session from now on feeds your monster.

## How it works

1. **Install** — `aimonsters init` registers an MCP server with Claude Code
2. **Code** — use Claude as normal, your monster feeds automatically
3. **Evolve** — your coding style (refactoring, features, debugging) shapes creature traits
4. **Collect** — each project gets its own unique creature

## Commands

```bash
aimonsters              # Show your creature
aimonsters show --all   # Show all your creatures
aimonsters stats        # Detailed session history
aimonsters login        # Link to your web profile
aimonsters help         # All commands
```

## Creature DNA

Every creature is shaped by your actual code:

- **Language** → element type (TypeScript=⚡, Python=🌿, Rust=⚙️)
- **Framework** → form style (React=interconnected, Django=structured)
- **Domain** → archetype (fitness=💪, social=🪽, ML=🧠, API=🛡️)
- **Coding style** → color palette (builder, debugger, refactorer)

## Progression

Levels are hard-earned:

| Level | Tokens Required | Approx. Effort |
|-------|----------------|----------------|
| 1 | 10K | ~1 session |
| 3 | 75K | ~1 week |
| 5 | 350K | ~2 weeks heavy |
| 7 | 1.5M | ~1-2 months |
| 10 | 12M | ~6+ months |
| 15 | 500M | Mythical |

## Privacy

No source code ever leaves your machine. Only metadata (token counts, language stats, git hashes) syncs to the web profile.

## License

MIT