Decision records
Each record explains one choice: the context, the options and the outcome. Records are never edited after they are accepted; a new record replaces an old one.
| # | Decision | Status |
|---|---|---|
| 0001 | Go for the client and host helper, Bubble Tea v2 for the screens | Accepted |
| 0002 | Our own holder process per session, not zmx | Accepted |
| 0003 | The system OpenSSH client as the only transport | Accepted |
| 0004 | Reattach by byte offset, with a full redraw as the fallback | Accepted |
| 0005 | Apache-2.0 with a DCO (DCO part replaced by 0010) | Accepted |
| 0006 | Detach key, image key and memory cap defaults | Accepted |
| 0007 | The product name lives in one package | Accepted |
| 0008 | Cap sessions with MemoryMax only, not MemoryHigh (replaces part of 0006) | Accepted |
| 0009 | A light launcher, and a session that owns the whole terminal (replaces the first home-screen design; its look is replaced by 0012) | Accepted |
| 0010 | No sign-off or attribution lines in commits (replaces the DCO part of 0005) | Accepted |
| 0011 | The launcher remembers: it draws at once and opens where you left off | Accepted |
| 0012 | Our own look: a signal, not a copy of Amp (replaces the look in 0009) | Accepted |
| 0013 | Host providers: Lima and E2B first, over a byte-stream transport | Accepted |
| 0014 | Code layout: thin mains, an importable command tree, black-box tests under test/ | Accepted |
| 0015 | Docs toolchain: Hugo with Hextra, a Diátaxis docs folder and generated reference | Accepted |
| 0016 | Public repo layout: full community files at the root, GitHub config in .github/, private material out | Accepted |
| 0017 | Release signatures that any machine with OpenSSH can check | Accepted |
| 0018 | The feature set: what we build now, next and later | Accepted |
| 0019 | Alerts and event hooks run on the host | Accepted |
| 0020 | A guided setup: one command and one sheet, over one engine | Proposed |
Write a new record from the template.