HazAT

HazAT / pi-solo

Public

Pi extension for Solo (soloterm.com) — registers every Solo MCP tool as a first-class Pi tool, auto-binds to SOLO_PROCESS_ID, idle-closes the helper, and renders Solo keyboard shortcuts in tool results.

24
0
100% credibility
Found May 19, 2026 at 37 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

pi-solo is a free add-on that connects Pi (an AI coding assistant) to Solo (a local development workspace for Mac). Once installed, it automatically links the two programs so your AI assistant can see and use your workspace tools like shared notes, to-do lists, and timers. The add-on displays a helpful status banner showing what's connected and lets you launch smaller AI helpers that work alongside your main assistant. These helpers save their results to shared notes, and you get notified when they're done. Everything resumes properly after restarts, and the connection closes automatically when you're not using it to keep things running smoothly.

How It Works

1
💻 You have Solo and Pi

You've been using Solo as your local development workspace and Pi as your AI coding assistant on your Mac.

2
🔌 You install the connection

You install pi-solo, a small add-on that lets your AI assistant talk directly to your workspace.

3
✨ Everything connects automatically

The moment you start working, your AI assistant sees your workspace tools and shows a beautiful status banner at the top.

4
📋 Your tools are ready to use

You can immediately use scratchpads, to-do lists, and timers directly in your conversations without any extra setup.

5
You can launch helper assistants
🔍
Scout explores the codebase

A quick helper that investigates your project and shares what it finds in a shared note.

📝
Planner thinks ahead

A thoughtful helper that maps out your next steps and saves a plan for everyone to see.

🔧
Worker tackles a task

A focused helper that works on something while you do something else.

6
📬 Helpers report back

When a helper finishes, you get a gentle notification and can read their work in the shared notes.

🎉 Your whole team works together

Your main AI assistant and its helpers collaborate seamlessly, sharing results through notes and picking up right where they left off after any restart.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 37 to 24 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is pi-solo?

Pi-solo is a native integration layer that connects Pi, Aaron Francis's local coding agent, with Solo, his terminal-based development workspace for macOS. It speaks the MCP protocol over stdio to Solo's bundled helper, exposing Solo's tool catalog (todos, scratchpads, timers, locks, process management) as first-class Pi tools. The extension also supports spawning subagents as real Solo agent processes, complete with session persistence and artifact scratchpads. It ships with a bundled GitHub-dark theme and renders keyboard shortcuts in tool results so you can jump straight to subagents in Solo's sidebar.

Why is it gaining traction?

The hook is tight integration. Subagents spawn as native Solo panes with proper state tracking, idle timers, and keyboard navigation. When you call a subagent, it runs in a real Solo process that appears in the sidebar with its own state indicator. The parent Pi wakes up automatically when the child goes idle, and artifacts land in Solo scratchpads rather than local files. The idle-close behavior keeps Solo's sidebar clean even though a helper subprocess is running. This is fundamentally more cohesive than wiring two separate tools together yourself.

Who should use this?

macOS developers already running both Pi and Solo who want their AI agents to share a unified workspace. If you're using Pi to orchestrate multi-agent workflows, this gives each subagent its own Solo pane with proper process lifecycle management. It's also useful if you want to call Solo-specific tools like scratchpads and timers directly from Pi without leaving the Pi prompt.

Verdict

This is a polished piece of engineering for a very specific setup: macOS + Pi + Solo. The documentation is thorough and the idle-close/subagent patterns show real thought. However, with 24 stars and a 1.0% credibility score, it's early-stage and the audience is self-selected. If you already live in Solo, this extension makes Pi feel native rather than bolted on. If you're not using Solo, skip it. The requirement for Solo 0.7.1+ and macOS 14+ narrows the practical audience considerably.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.