diff --git a/README.md b/README.md index 2f4354c8c..90c13886a 100644 --- a/README.md +++ b/README.md @@ -4,12 +4,22 @@ # PostHog Array Monorepo -This is the monorepo for PostHog's Array desktop task manager and the agent framework that powers it. +This is the monorepo for PostHog's Array desktop task manager, the `arr` CLI for stacked PRs, and the agent framework that powers them. ## Projects -- **[apps/array](./apps/array)** - The Array desktop application -- **[packages/agent](./packages/agent)** - The TypeScript agent framework +| Package | Description | +|---------|-------------| +| **[apps/array](./apps/array)** | Electron desktop app for AI-assisted task management with git worktree isolation | +| **[apps/cli](./apps/cli)** | `arr` CLI for stacked PR management using Jujutsu | +| **[packages/agent](./packages/agent)** | TypeScript agent framework wrapping Claude Agent SDK | +| **[packages/core](./packages/core)** | Shared business logic for jj/GitHub operations | + +## arr CLI + +`arr` is a CLI for stacked PR management using Jujutsu (`jj`). Split your work into small changes, push them as a PR stack, and keep everything in sync. + +See the [arr CLI README](./apps/cli/README.md) for installation and usage. ## Development @@ -63,9 +73,11 @@ pnpm test ``` array-monorepo/ ├── apps/ -│ └── array/ # Electron desktop app +│ ├── array/ # Electron desktop app +│ └── cli/ # arr CLI for stacked PRs ├── packages/ -│ └── agent/ # Agent framework +│ ├── agent/ # Agent framework (Claude Agent SDK wrapper) +│ └── core/ # Shared jj/GitHub business logic ├── pnpm-workspace.yaml # Workspace configuration └── package.json # Root package.json ```