SawyerHood/middleman

SawyerHood profile

Latest recorded source activity: March 19, 2026 at 22:29

SkillsMP catalog refreshed: October 17, 2026 at 00:09

skills collected: 4

GitHub stars: 184
GitHub forks: 21

Repository README

Repository README source: README.md

Read the source README

Expand full README

> [!IMPORTANT] > Middleman is being superseded by [bb](https://github.com/ymichael/bb), an agentic IDE that orchestrates Claude Code, Codex, and Pi in long-lived threads you can follow live and steer at any turn. > Try it with `npx bb-app@latest`, then open `http://localhost:38886`. Requires Node 22.12.0+ on macOS/Linux, or Windows via WSL2. <p align="center"> <img src="docs/images/middleman-header.png" alt="Middleman" width="100%"> </p> # 👔 Middleman A local-first multi-agent orchestration platform. One manager, many workers, zero tab-juggling. > [!WARNING] > Middleman is pre-v1, experimental, and updated constantly. Expect breaking changes. If you're using agentic coding tools, you've probably hit this wall: you start with one agent, then two, then five. You're branching, worktree-ing, reviewing, merging, context-switching. The agents are cranking out code. But your entire day is spent _managing them_, sequencing work, checking output, nudging things along. You're not an IC anymore. You've become a project manager. You need a middle manager. **Middleman gives you one.** You talk to a single persistent manager agent per project. You describe what needs to be done, whether it's a feature, a batch of bug fixes, or a refactor, and the manager dispatches workers, parallelizes where it makes sense, and surfaces only the things that need your attention. ![Middleman UI](docs/images/ui-screenshot.png) ## Quick Start ```bash npx middleman-app ``` That's it. Open `http://localhost:47187`, go to **Settings**, sign in with your OpenAI or Anthropic key, create a new manager, and start talking. ## Development ```bash git clone https://github.com/SawyerHood/middleman.git cd middleman pnpm i pnpm dev # http://127.0.0.1:47187 ``` ## Key Features - **Persistent managers.** Onboard once, work for days. Managers remember your preferences, workflow, and project context across sessions via compacting memory. - **Worker dispatch.** The manager spawns workers (Codex, Pi/Opus, etc.) and routes messages between them. You describe work at a high level; it handles the breakdown. - **Parallel execution.** Dump a list of tasks and the manager figures out what can run concurrently. - **Dashboard.** A Conductor-style UI for watching agents work, chatting with your manager, and managing settings. - **Skills & automation.** Built-in skills for web search, image generation, browser automation, cron scheduling, and more. Extensible via the pi skill system. ## Architecture Middleman is three things running on your machine: ``` ┌─────────────────────────────────────────────┐ │ Dashboard UI (TanStack + Vite SPA) │ │ Chat, agent status, settings, artifacts │ └──────────────────┬──────────────────────────┘ │ WebSocket ┌──────────────────▼──────────────────────────┐ │ Backend Daemon (Node.js) │ │ HTTP + WS server, agent orchestration, │ │ message routing, persistence, scheduler │ └──────────────────┬──────────────────────────┘ │ spawns & messages ┌──────────────────▼──────────────────────────┐ │ Agents (pi / Codex) │ │ Manager → Workers → Merger │ │ Each in its own worktree │ └─────────────────────────────────────────────┘ ``` - **`apps/backend`** is the daemon. HTTP + WebSocket server, swarm orchestration runtime, persistence, and scheduler. - **`apps/ui`** is the dashboard. Real-time agent monitoring, chat interface, and settings management. - The **manager agent** is built on [pi](https://github.com/badlogic/pi-mono), is event-driven, and never blocks. Always ready for the next message. ## How It Works in Practice 1. **Create a manager** for your project from the dashboard. 2. **Onboard it** by chatting. Tell it your preferred workflow, what tools to use, how you want work sequenced. 3. **Dump tasks** on it. A feature spec, a list of bugs, a vague idea. 4. The manager **spawns workers**, assigns tasks, and orchestrates execution in parallel where possible. 5. You **review** when you want, or let it roll. ## A Note This is a vibecoded project. It's here to inspire, not to be a polished product. Fork it, tear it apart, or use it as a starting point to build your own middle manager. ## License Apache-2.0

Loading the repository README…

Skills in this repository

Software Developers

1 occupation categories · 100% classified

skill

occupation

description

updated

brave-search

Software Developers

Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.

2026-03-19

cron-scheduling

Software Developers

Create, list, and remove persistent scheduled tasks using cron expressions.

2026-03-19

image-generation

Software Developers

Generate images using Google Gemini (gemini-3-pro-image-preview). Requires GEMINI_API_KEY.

2026-03-19

memory

Software Developers

Update persistent swarm memory in ${SWARM_MEMORY_FILE} when the user explicitly asks to remember, update, or forget durable information.

2026-03-19

Showing 4 of 4 collected skills.

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/SawyerHood/middleman.