Skip to content

Commit 79c9fbe

Browse files
donjor-agent[bot]donjor
authored andcommitted
docs(fork): README showcase clips for each fork domain (#1637)
## Problem The fork README lists each domain in words only. A reader cannot see what a domain does without installing the build. ## Change - **Showcase:** one short main clip per domain - **Clips:** collapsed extras under each showcase - **Device approval:** new section (device-auth) - **zmux:** where to enable **Terminal session** No clips for backend attach, device approval, or releases: nothing visible to show. ## Scope and approval Requested by the fork owner: README showcase clips for every fork domain. Docs only; no code changes. ## Showcase ### Multiple windows Open a second window, then filter each window to its own projects. https://github.com/user-attachments/assets/13204279-65d2-4599-b111-9c5043ca98fd <details> <summary>Clips</summary> **One thread in two windows, streaming in both** https://github.com/user-attachments/assets/61675d70-4b33-4337-b322-d7c86a20c2c7 **Relaunch: windows return to their workspaces** https://github.com/user-attachments/assets/426db6b1-9a38-4719-9911-6d3bcb4a017b </details> ### Custom agents Pick `pirate`; the reply turns pirate. https://github.com/user-attachments/assets/29c94d1c-cbf2-477f-b4ea-52193ccc5b5a <details> <summary>Clips</summary> **The project agent behind it: `.claude/agents/pirate.md`** https://github.com/user-attachments/assets/78f1f4b6-1162-4498-b5ca-95542e40f15f </details> ### Rich Markdown editing Type `#`, lists, tasks, quotes, and a code fence. https://github.com/user-attachments/assets/f3b4c546-8c33-4f11-97bc-1c2eff67d195 <details> <summary>Clips</summary> **Rich and Source views of an existing file** https://github.com/user-attachments/assets/4dc25fb0-3ed7-4cc2-9eee-d5b34eb3cd57 </details> ### Managed zmux terminals https://github.com/user-attachments/assets/3fa4a68f-a189-4ca8-98d5-416e8c9eb4fd ### Worktrunk worktrees `wt.toml`, then `pre-start` writes `PORT=` to `.env.local`. https://github.com/user-attachments/assets/1758bb95-19f6-4ed1-a8d8-56366444f62f <details> <summary>Clips</summary> **Removal runs `pre-remove`** https://github.com/user-attachments/assets/0dfb8ebb-2145-4a81-92b5-d9c3b3a02a16 </details> ### GitHub issues https://github.com/user-attachments/assets/9d21df4b-8a5f-425e-9a59-2de67b2e7520 ### Threads https://github.com/user-attachments/assets/532802d4-4ddc-473e-b337-4f2c5906d3f8 ### Browser bookmarks https://github.com/user-attachments/assets/0992bf8a-37c7-425b-992c-5d08c61cc22e ### Workspace files https://github.com/user-attachments/assets/46931a1e-d0f3-41d2-bf61-8fb79db19713 ## Verification ### Capture - **Build:** dev app from this branch, `33c7ecfbfbc` - **Data:** seeded demo projects - **Privacy:** owner's own agent names blurred - **Capture:** `donjor hypr record`, virtual monitor - **Review:** each final file as 1 fps frames ### Checks - **Fork CI:** `vp run fork:ci` exits 0 - **Lint:** README adds no `writing-md` findings <details> <summary>Cut table</summary> | Clip | Span | Real | Clip | | --- | --- | --- | --- | | Windows launch | trim only | 18.4s | 18.4s | | Windows same thread | agent reply | 4.6s | 2x | | Windows relaunch | app restart | 10.0s | 3x | | Custom agents | send | 3.5s | 2x | | Custom agents | agent reply | 10.0s | 4x | | Agent file | trim only | 6.9s | 6.9s | | Markdown typing | typing | 13.0s | 2x | | Markdown views | Source-mode idle | 56.0s | cut | | zmux | idle | 4.5s | cut | | zmux | session attach | 5.0s | 3x | | Worktrunk create | agent picker | 1.1s | cut | | Worktrunk create | agent working | 7.5s | 5x | | Worktrunk remove | tab switch | 3.5s | 2x | | GitHub issues | trim only | 9.2s | 9.2s | | Threads | group naming | 7.0s | 4x | | Threads | menu dwell | 19.5s | cut | | Bookmarks | menu, empty state | 10.0s | cut | | Workspace files | idle | 21.5s | cut | Sped spans show their `Nx` label on screen. The relaunch clip is staged: restore state was seeded as after an update. The custom agents clip blurs the picker rows except Default and `pirate`. </details> Claude Opus 5.5, Claude Code in T3 Code. ## Fork trailers Fork-Domain: fork-meta Fork-Tier: qol Co-authored-by: donjor <[email protected]>
1 parent 4e1f681 commit 79c9fbe

1 file changed

Lines changed: 67 additions & 0 deletions

File tree

‎README.md‎

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,9 +33,25 @@ The fork encodes none of that policy.
3333
| `mod+alt+o` | Reuse a window showing this project, else open |
3434

3535
- **Filter:** narrows lists, never hides live work
36+
- **Same thread:** **Open in New Window**, both live
3637
- **Update:** back on their Hyprland workspaces
3738
- **Old links:** `#/project/...` links still open
3839

40+
https://github.com/user-attachments/assets/13204279-65d2-4599-b111-9c5043ca98fd
41+
42+
<details>
43+
<summary>More clips</summary>
44+
45+
**One thread in two windows, streaming in both**
46+
47+
https://github.com/user-attachments/assets/61675d70-4b33-4337-b322-d7c86a20c2c7
48+
49+
**Relaunch: windows return to their workspaces**
50+
51+
https://github.com/user-attachments/assets/426db6b1-9a38-4719-9911-6d3bcb4a017b
52+
53+
</details>
54+
3955
## What else the fork adds
4056

4157
Every fork commit belongs to one domain, and each domain retires when upstream covers it.
@@ -47,51 +63,102 @@ The [fork delta](docs/fork/internals/fork-delta.md) owns the full list and bound
4763
- **Select:** one as the main thread
4864
- **Persist:** across new and resumed sessions
4965

66+
https://github.com/user-attachments/assets/29c94d1c-cbf2-477f-b4ea-52193ccc5b5a
67+
68+
<details>
69+
<summary>More clips</summary>
70+
71+
**The project agent behind it: `.claude/agents/pirate.md`**
72+
73+
https://github.com/user-attachments/assets/78f1f4b6-1162-4498-b5ca-95542e40f15f
74+
75+
</details>
76+
5077
### Rich Markdown editing
5178

5279
- **Modes:** Rich and Source for Markdown files
5380
- **Save:** CommonMark, GFM, frontmatter intact
5481
- **MDX:** stays a read-only preview
5582
- [Guide](docs/fork/user/markdown-editing.md)
5683

84+
https://github.com/user-attachments/assets/f3b4c546-8c33-4f11-97bc-1c2eff67d195
85+
86+
<details>
87+
<summary>More clips</summary>
88+
89+
**Rich and Source views of an existing file**
90+
91+
https://github.com/user-attachments/assets/4dc25fb0-3ed7-4cc2-9eee-d5b34eb3cd57
92+
93+
</details>
94+
5795
### Managed `zmux` terminals
5896

5997
- **Attach:** terminals join the checkout session
6098
- **Worktrees:** new ones join the same session
6199
- **Shared:** visible from T3 Code and the CLI
100+
- **Enable:** **Terminal session** in Appearance
62101
- [Guide](docs/fork/user/managed-terminals.md)
63102

103+
https://github.com/user-attachments/assets/3fa4a68f-a189-4ca8-98d5-416e8c9eb4fd
104+
64105
### Worktrunk worktrees
65106

66107
- **Mode:** **New worktrunk** for a thread
67108
- **Hooks:** `wt` hooks on create and remove
109+
- **Proof:** `pre-start` writes `.env.local`
68110
- **Fallback:** plain worktrees without `wt`
69111

112+
https://github.com/user-attachments/assets/1758bb95-19f6-4ed1-a8d8-56366444f62f
113+
114+
<details>
115+
<summary>More clips</summary>
116+
117+
**Removal runs `pre-remove`**
118+
119+
https://github.com/user-attachments/assets/0dfb8ebb-2145-4a81-92b5-d9c3b3a02a16
120+
121+
</details>
122+
70123
### GitHub issues
71124

72125
- **Browse:** issues on web and desktop
73126
- **Detail:** filters, comments, and tabs
74127
- **Hand off:** one issue to a new thread as a draft
75128

129+
https://github.com/user-attachments/assets/9d21df4b-8a5f-425e-9a59-2de67b2e7520
130+
76131
### Threads
77132

78133
- **Group:** related active threads in the sidebar
79134
- **Fork:** continue a copy on the same provider
80135

136+
https://github.com/user-attachments/assets/532802d4-4ddc-473e-b337-4f2c5906d3f8
137+
81138
### Browser bookmarks
82139

83140
- **Collections:** global and per project
84141
- **Star:** save, move, or remove a page
85142
- **New tab:** bookmarks listed first
86143
- [Guide](docs/fork/user/browser.md)
87144

145+
https://github.com/user-attachments/assets/0992bf8a-37c7-425b-992c-5d08c61cc22e
146+
88147
### Workspace files
89148

90149
- **Reveal:** gitignored agent artifacts on demand
91150
- **Default:** hidden, remembered per device
92151
- **Safety:** containment holds unless trusted
93152
- [Guide](docs/fork/user/workspace-files.md)
94153

154+
https://github.com/user-attachments/assets/46931a1e-d0f3-41d2-bf61-8fb79db19713
155+
156+
### Device approval
157+
158+
- **Grant:** RFC 8628-style device flow
159+
- **Approve:** on the host, `t3 auth device approve`
160+
- **Token:** never passes through a person
161+
95162
### Backend attach
96163

97164
- **Attach:** desktop joins a running backend

0 commit comments

Comments
 (0)