---
description: Initialize Checkmate in a project
---
# Initialize Checkmate
Set up Checkmate API testing in the current directory.
## Usage
```bash
# Interactive mode (prompts for base URL)
cm init
# Non-interactive mode (for agents)
cm init --url http://localhost:8080
# Stealth mode (don't track .checkmate/ in git)
cm init --url http://localhost:8080 --stealth
```
## What Gets Created
```
.checkmate/
├── config.toml # Project configuration
├── tests/ # Test specifications (YAML)
├── runs/ # Test run history (JSONL)
└── hooks/ # Custom hook scripts
```
## Next Steps
1. Create test specs in `.checkmate/tests/`
2. Run `cm test run` to execute tests
3. Run `cm docs` for full documentation