💙

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

cargo build --release
./target/release/blue install

Configures hooks, skills, and MCP for Claude Code. Restart Claude Code after installation.

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

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

Playwright MCP with Chrome Profiles

By default, Playwright MCP launches a fresh browser with no saved sessions. To use your existing Chrome profile (with saved logins), copy the profile and point Playwright at the copy.

Setup:

1. Copy your Chrome profile to a temp location (avoids profile lock conflicts):

   mkdir -p /tmp/chrome-profile
   cp -r ~/Library/Application\ Support/Google/Chrome/Default /tmp/chrome-profile/Default
   cp ~/Library/Application\ Support/Google/Chrome/Local\ State /tmp/chrome-profile/
   

2. Update .claude/plugins/.../playwright/.mcp.json:

   {
     "playwright": {
       "command": "npx",
       "args": [
         "@playwright/mcp@latest",
         "--executable-path", "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
         "--user-data-dir", "/tmp/chrome-profile"
       ]
     }
   }
   

3. Restart Claude Code.

Limitations:

• Saved passwords won't autofill (Keychain encryption is path-bound). Usernames fill fine.
• Copy your passwords from chrome://password-manager/passwords in your regular Chrome as needed.
• Sessions stay active within the Playwright instance, so you only log in once per site.
• Re-copy the profile if you need fresh cookies/sessions.

What didn't work:

• --remote-debugging-port=9222: Chrome on macOS silently ignores TCP port binding.
• --extension mode with Playwright MCP Bridge: Opens a new profile instead of connecting to the existing one.
• Direct --user-data-dir pointing to the live Chrome profile: Lock file conflicts.

Quick Setup

cargo build --release
./target/release/blue install
# Restart Claude Code

Then in Claude:

Human: blue status
Claude: [calls blue_status] Project: blue, Branch: develop...

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.

🧁