Repository navigation
Decision Records
Ryan Stoffel edited this page Oct 29, 2026
·
1 revision
A decision that affects more than one issue gets a record in docs/decisions/. Records supersede docs/PLAN.md where they differ, and a later record can supersede an earlier one. The full index lists every record with a one-line summary.
This page groups them by topic. Records are written for contributors and describe the decision as made, so the code is the final word on what ships.
| Record | Topic |
|---|---|
| 0001 | CI before product code |
| 0021 | Linear is the work record |
| 0003 | Naming: Parallax and plxd
|
| 0018 | PR visuals on request |
| Record | Topic |
|---|---|
| 0022 | The desktop app's stack and layout |
| 0023 | macOS, Windows, and Linux |
| 0085 | UI style guide |
| 0083 | A Project's surfaces read as one place |
| 0033 | Sidebar shows what needs you |
| 0075 | Arc-style sidebar |
| 0087 | Rows, no areas or folders |
| 0090 | Projects page and Spaces |
| 0073 | Areas |
| 0076 | Chrome extensions in the side panel browser |
| Record | Topic |
|---|---|
| 0007 | JSON-RPC over plxd attach
|
| 0010 | How plxd attach starts plxd |
| 0009 | Data folder and exit codes |
| 0052 | Orchestration kernel |
| 0059 | Orchestration rewrite after T3 Code |
| 0060 | Provider sessions across turns |
| 0016 | Event log retention |
| 0014 | Agent runs |
| 0013 | Worker sandbox |
| Record | Topic |
|---|---|
| 0017 | Normal threads |
| 0034 | A thread is full Claude Code |
| 0027 | Claude permission modes |
| 0031 | Permission requests over stdio |
| 0054 | Access levels for every provider |
| 0048 | Queued messages and steer |
| 0049 | Resume after usage limits |
| 0050 | Fork a thread at a turn |
| 0058 | Thread naming |
| 0062 | Checkpoints and revert |
| 0047 | Thread search and context |
| 0026 | Images in prompts |
| 0071 | File uploads |
| 0074 | Files move in chunks |
| 0041 | Thread lineage and host MCP |
| Record | Topic |
|---|---|
| 0004 | Subscriptions through official CLIs |
| 0012 | Account routing |
| 0040 | Provider instances and ACP agents |
| 0061 | Claude through the Agent SDK |
| 0035 | Codex on codex app-server
|
| 0036 | Cursor threads |
| 0053 | Cursor through its SDK |
| 0055 | OpenCode over HTTP |
| 0070 | Ollama Cloud |
| 0088 | Account pools are gone, several accounts warn |
| 0089 | CLIProxyAPI hubs |
| 0039 | Usage page |
| 0050 | GitHub setup with gh
|
| 0086 | GitHub through plxd |
| 0067 | Parallax accounts in Clerk |
| 0037 | Supabase accounts (superseded by 0067) |
| Record | Topic |
|---|---|
| 0024 | Coordinator chat |
| 0042 | Children are threads |
| 0078 | Coordinator instructions are pinned |
| 0079 | Coordinator continuity |
| 0019 | Coordinator MCP tools |
| 0025 | Coordinator wake-ups |
| 0043 | Inbox and autonomy |
| 0044 | Project memory |
| 0005 | Shared context folder |
| 0081 | Board items |
| 0082 | You memory across machines |
| 0045 | Integration branch |
| 0046 | Placing children across accounts |
| 0057 | Threads on another computer |
| 0032 | Names and icons |
| 0038 | Image icons |
| 0069 | Spaces |
| Record | Topic |
|---|---|
| 0063 | Schedules, webhooks, PR watches, delegation |
| 0064 | Terminals and browser, HTML, device tools |
| 0077 | Computer use |
| 0084 | iOS Simulator streaming |
| Record | Topic |
|---|---|
| 0065 | Reach from any device |
| 0056 | Parallax Connect over Tailscale |
| 0072 | Connect keeps plxd running |
| 0068 | Parallax Relay |
| 0066 | Updating connected hosts |
| Record | Topic |
|---|---|
| 0028 | Nightly and standard releases |
| 0051 | Promote a nightly |
| 0029 | App packaging |
| 0030 | Release versions and signing |
| 0006 | Versioning and packaging (early) |
| Record | Topic |
|---|---|
| 0002 | Editor fork strategy |
| 0008 | Editor overlay |
| 0011 | Agents window baseline |
| 0015 | Subagent chats |
| 0020 | Drop the editor fork |
Start
Using Parallax
Your computers
Maintenance
Contributing