middleman - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #typescript #golang #machine-learning #rust #linux #macos #windows #awesome-list #security #pytorch #ios

middleman

(★ 181)

The middle manager for your agents

파일 탐색기

최종 버전 다운로드 (.zip)

- - ci.yml
  - release.yml
- pre-commit
- - package.json
  - tsconfig.build.json
  - vitest.config.ts
- - package.json
  - tsconfig.build.json
- - .gitignore
  - package.json
  - README.md
  - tailwind.config.ts
  - tsconfig.json
  - vite.config.ts
- - .cta.json
  - .gitignore
  - components.json
  - package.json
  - playwright.config.ts
  - README.md
  - tsconfig.json
  - vite.config.ts
  - vitest.config.ts
- - manager.jsonl
  - prod-script-worker.jsonl
- - agents.json
- - middleman-header.png
  - ui-screenshot.png
- - package.json
  - tsconfig.json
- - .gitignore
  - AGENTS.md
  - package.json
  - README.md
  - tsconfig.json
  - vitest.config.ts
- build-npm-package.mjs
- prod-daemon-paths.mjs
- prod-daemon-restart.mjs
- prod-daemon.mjs
- prune-session-jsonl.mjs
.env.example
.gitignore
.mods
.prettierignore
.prettierrc
AGENTS.md
LICENSE
package.json
pnpm-lock.yaml
pnpm-workspace.yaml
profiling.md
README.md
README.package.md
RELEASING.md
tsconfig.json

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/SawyerHood/middleman

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd middleman

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

pnpm i

이 명령어를 터미널에 그대로 입력해 실행하세요.

pnpm dev

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

> [!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](https://raw.githubusercontent.com/SawyerHood/middleman/main/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