Eric Garcia daaaea5c82 feat(realm): Implement RFC 0001 cross-repo coordination and RFC 0002 Phase 1 MCP tools

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>

2026-01-24 07:14:35 -05:00

1.4 KiB

Raw Blame History

Blue CLI

Command-line interface for Blue.

Installation

cargo install --path apps/blue-cli

Or run directly:

cargo run --bin blue

Commands

Command	Description
`blue`	Show welcome message
`blue status`	Project status
`blue realm`	Cross-repo coordination
`blue session`	Work session management
`blue daemon`	Background service
`blue mcp`	Run as MCP server

Realm Commands

See realm.md for full documentation.

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

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

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:

blue mcp

Configure in Claude settings to enable Blue tools.

1.4 KiB Raw Blame History