Skip to content

feat: Initial arr CLI.md + setup instructions #488

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
charlesvien wants to merge 2 commits into from
Closed

feat: Initial arr CLI.md + setup instructions #488

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4cbf7fb
Update README.md
charlesvien Jan 13, 2026
0409a3b
Update README.md
charlesvien Jan 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 17 additions & 5 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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
```
Expand Down