daaaea5c82
RFC 0001 - Cross-Repo Coordination with Realms: - Daemon architecture with HTTP server on localhost:7865 - SQLite persistence for sessions, realms, notifications - Realm service with git-based storage and caching - CLI commands: realm status/sync/check/worktree/pr/admin - Session coordination for multi-repo work RFC 0002 Phase 1 - Realm MCP Integration: - realm_status: Get realm overview (repos, domains, contracts) - realm_check: Validate contracts/bindings with errors/warnings - contract_get: Get contract details with bindings - Context detection from .blue/config.yaml - 98% expert panel alignment via 12-expert dialogue Also includes: - CLI documentation in docs/cli/ - Spike for Forgejo tunnelless access - 86 tests passing Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
67 lines
1.4 KiB
Markdown
67 lines
1.4 KiB
Markdown
# Blue CLI
|
|
|
|
Command-line interface for Blue.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
cargo install --path apps/blue-cli
|
|
```
|
|
|
|
Or run directly:
|
|
|
|
```bash
|
|
cargo run --bin blue
|
|
```
|
|
|
|
## Commands
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `blue` | Show welcome message |
|
|
| `blue status` | Project status |
|
|
| `blue realm` | [Cross-repo coordination](realm.md) |
|
|
| `blue session` | Work session management |
|
|
| `blue daemon` | Background service |
|
|
| `blue mcp` | Run as MCP server |
|
|
|
|
## Realm Commands
|
|
|
|
See [realm.md](realm.md) for full documentation.
|
|
|
|
```bash
|
|
blue realm status # Show realm info
|
|
blue realm check # Validate contracts
|
|
blue realm sync # Commit changes
|
|
blue realm worktree create # Create RFC worktrees
|
|
blue realm pr status # Check PR readiness
|
|
blue realm admin init # Create realm
|
|
blue realm admin join # Join repo to realm
|
|
```
|
|
|
|
## Session Commands
|
|
|
|
```bash
|
|
blue session start --rfc <name> # Start work session
|
|
blue session list # List active sessions
|
|
blue session status # Current session info
|
|
blue session stop # End session
|
|
```
|
|
|
|
## Daemon Commands
|
|
|
|
```bash
|
|
blue daemon start # Start daemon (foreground)
|
|
blue daemon status # Check if running
|
|
blue daemon stop # Stop daemon
|
|
```
|
|
|
|
## MCP Server
|
|
|
|
Run Blue as an MCP server for Claude integration:
|
|
|
|
```bash
|
|
blue mcp
|
|
```
|
|
|
|
Configure in Claude settings to enable Blue tools.
|