superviber/blue
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Welcome home. A development philosophy and toolset.
75 commits 2 branches 0 tags 2 MiB
Rust 99.3%
Shell 0.7%
Find a file
Eric Garcia 607b5ce07c fix: add session-heartbeat and session-end CLI commands for hooks 
- Add top-level `session-heartbeat` command (silent, touches session file)
- Add top-level `session-end` command (silent, removes session file)
- Add `Heartbeat` variant to SessionCommands enum
- Required by global Claude Code hooks in ~/.claude/settings.json

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 10:03:31 -05:00
.blue feat: RFC 0041 compaction-resilient context injection 2026-01-30 10:01:40 -05:00
.claude feat: RFC 0038 SDLC workflow discipline implementation 2026-01-30 08:59:20 -05:00
apps/blue-cli fix: add session-heartbeat and session-end CLI commands for hooks 2026-01-30 10:03:31 -05:00
crates feat: RFC 0038 SDLC workflow discipline implementation 2026-01-30 08:59:20 -05:00
docs docs: add install scripts and MCP integration docs 2026-01-24 16:44:55 -05:00
hooks feat: RFC 0041 compaction-resilient context injection 2026-01-30 10:01:40 -05:00
knowledge feat: implement document sync and Claude Code task integration (RFC 0018, 0019) 2026-01-25 20:58:46 -05:00
skills/alignment-play feat: context injection architecture via 12-expert alignment dialogue 2026-01-25 16:16:11 -05:00
.gitignore fix: stop tracking blue.db and update .gitignore 2026-01-26 07:47:44 -05:00
Cargo.toml feat: RFC 0038 SDLC workflow discipline implementation 2026-01-30 08:59:20 -05:00
INSTALL.md docs: add install scripts and MCP integration docs 2026-01-24 16:44:55 -05:00
install.sh feat: RFC 0041 compaction-resilient context injection 2026-01-30 10:01:40 -05:00
README.md docs: Add ADR 0000 Never Give Up to beliefs list 2026-01-24 09:12:18 -05:00

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

  1. Never Give Up — The ground everything stands on
  2. Purpose — We exist to make work meaningful and workers present
  3. Presence — The quality of actually being here while you work
  4. Home — You are never lost. You are home.
  5. Evidence — Show, don't tell
  6. Single Source — One truth, one location
  7. Relationships — Connections matter
  8. Integrity — Whole in structure, whole in principle
  9. Honor — Say what you do. Do what you say.
  10. Courage — Act rightly, even when afraid
  11. No Dead Code — Delete boldly. Git remembers.
  12. Freedom Through Constraint — The riverbed enables the river
  13. Faith — Act on justified belief, not just proven fact
  14. 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.

🧁