489942cd35
RFC 0006 - Document Deletion Tools: - Add soft-delete with 7-day retention before permanent deletion - Add blue_delete, blue_restore, blue_deleted_list, blue_purge_deleted tools - Add deleted_at column to documents table (schema v3) - Block deletion of documents with ADR dependents - Support dry_run, force, and permanent options RFC 0007 - Consistent Branch Naming: - Strip RFC number prefix from branch/worktree names - Branch format: feature-description (not rfc/NNNN-feature-description) - PR title format: RFC NNNN: Feature Description - Add strip_rfc_number_prefix helper with tests Also: - Remove orphan .blue/repos/ and .blue/data/ directories - Fix docs path resolution bug (spike documented) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
73 lines
1.7 KiB
Markdown
73 lines
1.7 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
|
|
```
|
|
|
|
This exposes 8 realm coordination tools to Claude:
|
|
- `realm_status`, `realm_check`, `contract_get`
|
|
- `session_start`, `session_stop`
|
|
- `realm_worktree_create`, `realm_pr_status`
|
|
- `notifications_list`
|
|
|
|
See [../mcp/README.md](../mcp/README.md) for tool reference and [../mcp/integration.md](../mcp/integration.md) for setup guide.
|