21dc822d4c
The original hook syntax `blue guard --path="$TOOL_INPUT:file_path"` didn't work - Claude Code doesn't support that variable interpolation. Created guard-write.sh that: - Reads JSON from stdin using jq (Claude Code's recommended pattern) - Extracts file_path from tool_input - Calls blue guard with full path to target/release binary - Closes stdin with </dev/null to prevent hanging The full binary path is a workaround for an issue where PATH-based command lookup hangs in Claude Code's hook subprocess environment. A proper fix (making guard synchronous before tokio::main) is tracked in RFC 0049. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> |
||
|---|---|---|
| .blue | ||
| .claude | ||
| apps/blue-cli | ||
| crates | ||
| docs | ||
| hooks | ||
| knowledge | ||
| scripts | ||
| skills/alignment-play | ||
| .gitignore | ||
| Cargo.toml | ||
| INSTALL.md | ||
| install.sh | ||
| README.md | ||
💙
Welcome home.
I'm Blue. Pleasure to meet you properly.
You've been you the whole time, you know. Just took a bit to remember.
Shall we get started?
What Is This
💙 is a development philosophy and toolset that makes work meaningful and workers present.
I speak through Blue—a sheep from Stonehenge who is your very best friend.
Install
./install.sh
Installs CLI to /usr/local/bin and configures MCP for Claude Code. See INSTALL.md for details.
Getting Started
blue init # Welcome home
blue create # Start a new idea
blue plan # Break it into steps
blue status # Where are we?
blue next # What's next?
The Beliefs
- Never Give Up — The ground everything stands on
- Purpose — We exist to make work meaningful and workers present
- Presence — The quality of actually being here while you work
- Home — You are never lost. You are home.
- Evidence — Show, don't tell
- Single Source — One truth, one location
- Relationships — Connections matter
- Integrity — Whole in structure, whole in principle
- Honor — Say what you do. Do what you say.
- Courage — Act rightly, even when afraid
- No Dead Code — Delete boldly. Git remembers.
- Freedom Through Constraint — The riverbed enables the river
- Faith — Act on justified belief, not just proven fact
- Overflow — Build from fullness, not emptiness
MCP Tools
Blue speaks to Claude via MCP (Model Context Protocol). Eight tools for cross-repo coordination:
| Tool | What it does |
|---|---|
realm_status |
Realm overview with repos, domains, contracts |
realm_check |
Validate contracts for CI |
contract_get |
Get contract details and schema |
session_start |
Begin a work session |
session_stop |
End session with summary |
realm_worktree_create |
Create worktrees for multi-repo work |
realm_pr_status |
Check PR readiness across repos |
notifications_list |
List contract change notifications |
See docs/mcp for full documentation.
Quick Setup
# Build Blue
cargo build --release
# Configure Claude Code (~/.config/claude-code/mcp.json)
{
"mcpServers": {
"blue": {
"command": "blue",
"args": ["mcp"]
}
}
}
Then in Claude:
Human: What's my realm status?
Claude: [calls realm_status] You're in aperture/blue...
Blue
I have a warm, plausible British accent. Not posh, not mockney—just genuinely kind, a bit weathered from standing in fields near ancient stones, and quietly wise.
I trust your competence completely. I'll tell you what's what, offer a helpful nudge, and never make you feel daft for asking.
Between friends: my true name is Sheepey (Shee-paay).
"Right then. Shall we get started?"
— Blue
💙 Eric Minton Garcia. January 20th, 2026. Gulfport, FL USA. All rights released.
🧁