# Suggested Commands

## Build Commands
```bash
# Development build
cargo build

# Release build (optimized)
cargo build --release

# Run with features
cargo run --features binary -- <args>
```

## Test Commands
```bash
# Run all tests
cargo test

# Run specific test file
cargo test --test <test_name>

# Run unit tests only
cargo test --lib

# Run with output
cargo test -- --nocapture
```

## Lint and Format
```bash
# Check code
cargo check

# Run clippy linter
cargo clippy

# Format code
cargo fmt

# Format check
cargo fmt -- --check
```

## Running the Application
```bash
# Development run
cargo run -- <args>

# Example: AI CLI routing
cargo run -- claude "explain this code"
cargo run -- codex -r common "write tests"
cargo run -- auto "fix this bug"

# Example: MCP commands
cargo run -- mcp serve
cargo run -- mcp list
cargo run -- mcp browse

# Example: Other commands
cargo run -- status
cargo run -- roles list
cargo run -- update
```

## Release Commands
```bash
# NPM release
npm version patch|minor|major
npm publish

# Version check
cat VERSION
```

## Git Commands
```bash
# Standard workflow
git add .
git commit -m "feat: description [REQ-XXX]"
git push origin master
```

## Useful Development Commands
```bash
# Check dependencies
cargo tree

# Update dependencies
cargo update

# Clean build artifacts
cargo clean
```
