Skip to content

Decision Records

Ryan Stoffel edited this page Oct 29, 2026 · 1 revision

Decision Records

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.

Process and repo

Record Topic
0001 CI before product code
0021 Linear is the work record
0003 Naming: Parallax and plxd
0018 PR visuals on request

Platform and app

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

plxd core

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

Threads

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

Providers and accounts

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)

Projects

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

Agent tools and triggers

Record Topic
0063 Schedules, webhooks, PR watches, delegation
0064 Terminals and browser, HTML, device tools
0077 Computer use
0084 iOS Simulator streaming

Remote access

Record Topic
0065 Reach from any device
0056 Parallax Connect over Tailscale
0072 Connect keeps plxd running
0068 Parallax Relay
0066 Updating connected hosts

Releases

Record Topic
0028 Nightly and standard releases
0051 Promote a nightly
0029 App packaging
0030 Release versions and signing
0006 Versioning and packaging (early)

History: the editor fork

Record Topic
0002 Editor fork strategy
0008 Editor overlay
0011 Agents window baseline
0015 Subagent chats
0020 Drop the editor fork

Clone this wiki locally