From 4cbf7fba874acb1c0732c96c1dd6030aff915d94 Mon Sep 17 00:00:00 2001 From: Charles Vien Date: Tue, 13 Jan 2026 10:45:20 -0800 Subject: [PATCH 1/2] Update README.md --- README.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 2f4354c8c..f897c4cfb 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,7 @@ This is the monorepo for PostHog's Array desktop task manager and the agent fram ## Projects - **[apps/array](./apps/array)** - The Array desktop application +- **[apps/cli](./apps/cli)** - The `arr` CLI for stacked PRs using jj - **[packages/agent](./packages/agent)** - The TypeScript agent framework ## Development @@ -17,6 +18,8 @@ This is the monorepo for PostHog's Array desktop task manager and the agent fram - Node.js 22+ - pnpm 10.23.0 +- [Bun](https://bun.sh/docs/installation) (for the CLI) +- [jj](https://martinvonz.github.io/jj/latest/install-and-setup/) (for the CLI) ### Setup @@ -31,6 +34,10 @@ pnpm install pnpm --filter agent build ``` +### Installing the CLI + +See the [arr CLI README](./apps/cli/README.md) for installation and usage instructions. + ### Running in Development ```bash @@ -63,7 +70,8 @@ pnpm test ``` array-monorepo/ ├── apps/ -│ └── array/ # Electron desktop app +│ ├── array/ # Electron desktop app +│ └── cli/ # arr CLI for stacked PRs ├── packages/ │ └── agent/ # Agent framework ├── pnpm-workspace.yaml # Workspace configuration From 0409a3b1a836b3b5c1e122d0c43b8b6f14090fc4 Mon Sep 17 00:00:00 2001 From: Charles Vien Date: Wed, 14 Jan 2026 08:23:58 -0800 Subject: [PATCH 2/2] Update README.md --- README.md | 26 +++++++++++++++----------- 1 file changed, 15 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index f897c4cfb..90c13886a 100644 --- a/README.md +++ b/README.md @@ -4,13 +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 -- **[apps/cli](./apps/cli)** - The `arr` CLI for stacked PRs using jj -- **[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 @@ -18,8 +27,6 @@ This is the monorepo for PostHog's Array desktop task manager and the agent fram - Node.js 22+ - pnpm 10.23.0 -- [Bun](https://bun.sh/docs/installation) (for the CLI) -- [jj](https://martinvonz.github.io/jj/latest/install-and-setup/) (for the CLI) ### Setup @@ -34,10 +41,6 @@ pnpm install pnpm --filter agent build ``` -### Installing the CLI - -See the [arr CLI README](./apps/cli/README.md) for installation and usage instructions. - ### Running in Development ```bash @@ -73,7 +76,8 @@ array-monorepo/ │ ├── 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 ```