orchestrator

KO | EN

gitlite — search

#python #hacktoberfest #ai #llm #go #golang #android #machine-learning #linux #vue #awesome-list #security #mcp #openai

(★ 14)

An event-sourced task orchestrator for AI-assisted software development. Breaks PRDs into tasks, runs them through configurable phases (test-author, implementer, auditor), manages git worktrees, and merges the results — all from a local web UI.

orchestrator 최신버젼 다운로드

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# @andycoupe/orchestrator

![Orchestrator screenshot](https://raw.githubusercontent.com/andrewmcoupe/orchestrator/main/assets/screenshot-1.png)

An event-sourced task orchestrator for AI-assisted software development. Breaks PRDs into tasks, runs them through configurable phases (test-author, implementer, auditor), manages git worktrees, and merges the results — all from a local web UI.

## Quick start

```bash
npx @andycoupe/orchestrator
```

Run this from the root of any git repository. On first run it will:

1. Scaffold a `.orchestrator/` directory (auto-added to `.gitignore`)
2. Seed a default config and prompt library
3. Create a few demo tasks so you can explore the UI
4. Open your browser to `http://localhost:4321`

### CLI options

```
--port <number>  Port to listen on (default: 4321)
--no-open        Don't open browser on start
--verbose        Verbose logging output
--quiet          Minimal logging output (default)
--init           Scaffold .orchestrator/ without starting server
--help           Show help
--version        Show version
```

## Prerequisites

- Node.js 20+
- Git
- One of the following:
  - Logged into [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (`claude` CLI)
  - Logged into [Codex CLI](https://github.com/openai/codex)
  - API keys set in `.orchestrator/.env.local`

## Configuration

After scaffolding, edit `.orchestrator/config.yaml` to configure:

- **Gates** — quality checks (typecheck, test, lint) that run before a task can be approved
- **Presets** — reusable task configurations (phases, models, retry policies)
- **Merge strategy** — squash, merge, or fast-forward only
- **Ingest settings** — model and transport for PRD ingestion

```yaml
gates:
  - name: typecheck
    command: pnpm typecheck
  - name: test
    command: pnpm test
  - name: lint
    command: pnpm lint
```

If using API keys directly instead of the CLI tools, set them in `.orchestrator/.env.local`:

```
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
```

## Writing a PRD

The orchestrator ingests PRDs as markdown. Each `##` section becomes a separate task that gets implemented independently in its own git worktree.

### Recommended: use the PRD generation skill

Install the [generate-orchestrator-prd](https://github.com/andrewmcoupe/ai-skills/tree/main/generate-orchestrator-prd) skill:

```bash
npx skills@latest add andrewmcoupe/ai-skills/generate-orchestrator-prd
```

Then use it:

```
/generate-orchestrator-prd
```

This will grill you on every aspect of your plan — scope, edge cases, data model, dependencies — resolving each branch of the decision tree before generating a `PRD.md` optimised for the orchestrator's ingest system.

### PRD structure

If writing a PRD manually, follow this structure:

```markdown
# Feature title

## Overview

Brief summary of what this feature does and why.

## Add rate limiter middleware

- Apply to all /api/* routes
- Use a sliding window of 100 requests per minute per IP
- Return 429 with a Retry-After header when exceeded

## Add rate limit headers to responses

- X-RateLimit-Limit: max requests per window
- X-RateLimit-Remaining: requests left
- X-RateLimit-Reset: UTC epoch when the window resets

## Implementation Touchpoints

| File | Change |
|---|---|
| `src/middleware/rateLimit.ts` | New rate limiter middleware |
| `src/app.ts` | Mount middleware on /api/* routes |

## Out of Scope

- Per-user rate limits (IP-based only for now)
```

Each `##` section should be specific, testable, and self-contained — the agent implementing it only sees that section and the codebase.

## Development

```bash
git clone https://github.com/andycoupe/orchestrator.git
cd orchestrator
pnpm install
pnpm dev
```

This starts:
- The Hono backend on `:3001`
- The Vite dev server on `:3000` (proxies API calls to the backend)

### Scripts

| Command | Description |
|---------|-------------|
| `pnpm dev` | Start backend + frontend in dev mode |
| `pnpm build` | Build server (tsc) + frontend (vite) |
| `pnpm test` | Run all tests |
| `pnpm lint` | Lint with oxlint |
| `pnpm typecheck` | TypeScript type checking |

### Project structure

```
server/          Backend (Hono, SQLite, event store)
web/             Frontend (React, TanStack Router, Tailwind)
shared/          Types and projections shared between server and client
templates/       Default config files copied on first scaffold
prompts/         Bundled prompt templates for each phase
```

### Release flow

1. **Add a changeset** when your PR includes user-facing changes:

```bash
   pnpm changeset
   ```

This prompts you to pick a semver bump (patch/minor/major) and write a summary. It creates a markdown file in `.changeset/` — commit it with your PR.

2. **Merge to main.** The release workflow runs automatically and creates a "Version Packages" PR that:
   - Bumps the version in `package.json`
   - Updates `CHANGELOG.md`
   - Consumes the changeset files

3. **Merge the Version Packages PR.** The workflow runs again and publishes to npm.

### CI

Every PR and push to `main` runs three parallel checks:

- **Lint** — `pnpm lint`
- **Test** — `pnpm test`
- **Build** — `pnpm build`

## License

MIT

orchestrator

orchestrator 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

orchestrator

orchestrator 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README