Skip to content

Commit b55929c

Browse files
donjor-agent[bot]donjor
authored andcommitted
docs(fork): any window is the T3 instance, filtered per window
## What Changed - **`AGENTS.md`:** any desktop window is the T3 instance; the hub line becomes the all-projects view - **Non-goals:** new row, all projects is a filter state, not a hub window - **Delta:** `project-windows` marked Legacy; its prose points at `multi-window` and `workspaces` - **Markers:** live `project-windows/*` hooks renamed to `multi-window/*` and `fork-meta/*` - **Provider env:** the comment says the ids name the work, not a window - **User docs:** "Choose a window's projects" in the thread sidebar guide, plus `projectFilter.choose` in keybindings ## Why Fork docs still described project windows and a hub after equal windows landed. `project-windows` cannot leave `FORK_DOMAINS` yet: 10 `hyprws` history commits carry `Fork-Domain: project-windows`, and `fork:delta --check` and `fork:scan` need the domain and its scan section while they do. Full retirement needs a `fork-fold` pass that retags those trailers; this PR does not rewrite history. ## Close conditions Closes #1348 - [x] **`AGENTS.md`:** any window is the T3 instance - [x] **Non-goals:** all-projects view, not hub - [ ] **Delta:** `project-windows` retired (markers gone; history trailers need `fork-fold`) - [x] **Provider env:** comment stops promising a window - [x] **User docs:** New Window and the filter ## Checks - `vp run fork:ci` → exit 0 (scripts 651/651) - `vpr typecheck` → exit 0 - `vp run knip:check` → exit 0 ## Checklist - [x] This PR is small and focused - [x] I explained what changed and why - [ ] I included before/after screenshots for any UI changes (docs only) - [ ] I included a video for animation/interaction changes (none) Claude Opus 5.5, Claude Code. ## Fork trailers Fork-Domain: fork-meta Fork-Tier: core Co-authored-by: donjor <[email protected]>
1 parent c7ded9f commit b55929c

7 files changed

Lines changed: 17 additions & 7 deletions

File tree

‎AGENTS.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@ Read [Fork delta](docs/fork/internals/fork-delta.md) before adding to the fork,
88

99
Upstream guidance below remains the default unless this section or the fork guide overrides it.
1010

11-
- Treat a project-scoped desktop window as the user's T3 instance.
12-
- Keep the hub available and share the Electron process, backend pool, auth, providers, and persisted state.
11+
- Treat any desktop window as the user's T3 instance.
12+
- Keep the all-projects view available and share the Electron process, backend pool, auth, providers, and persisted state.
1313
- Let Hyprland place windows across workspaces and monitors; do not encode compositor policy in T3 Code.
1414
- Keep local `main` identical to `upstream/main`; never add fork commits to it.
1515
- Maintain the fork delta on `hyprws`, the single fork trunk, and create focused worktrees from it with Worktrunk.

‎apps/desktop/src/ssh/DesktopSshPasswordPrompts.test.ts‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -91,12 +91,12 @@ function layerElectronWindow(window: ReturnType<typeof makeTestWindow>["window"]
9191
ElectronWindow.ElectronWindow.of({
9292
create: () => Effect.die("unexpected BrowserWindow creation"),
9393
main: Effect.succeedSome(window as Electron.BrowserWindow),
94-
get: () => Effect.succeedSome(window as Electron.BrowserWindow), // fork-hook: project-windows/ssh-prompts-window-get
94+
get: () => Effect.succeedSome(window as Electron.BrowserWindow), // fork-hook: multi-window/ssh-prompts-window-get
9595
getById: () => Effect.succeedSome(window as Electron.BrowserWindow), // fork-hook: multi-window/window-id-get-by-id
9696
getOrCreate: () => Effect.die("unexpected identity window creation"),
9797
createNew: () => Effect.die("unexpected new window creation"), // fork-hook: multi-window/dispatch-create-new
9898
close: () => Effect.void,
99-
windowIdFor: () => Effect.succeedNone, // fork-hook: project-windows/ssh-prompts-window-identity
99+
windowIdFor: () => Effect.succeedNone, // fork-hook: multi-window/ssh-prompts-window-identity
100100
listWindows: Effect.succeed([]), // fork-hook: multi-window/window-id-list
101101
windowsByRecency: Effect.succeed([]), // fork-hook: multi-window/window-targets-by-recency
102102
currentMainOrFirst: Effect.succeedSome(window as Electron.BrowserWindow),

‎apps/desktop/src/updates/updatesTestHarness.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -118,7 +118,7 @@ export function makeHarness(options: UpdatesHarnessOptions = {}) {
118118
const layerWindow = Layer.succeed(ElectronWindow.ElectronWindow, {
119119
create: () => Effect.die("unexpected BrowserWindow creation"),
120120
main: Effect.succeedNone,
121-
get: () => Effect.succeedNone, // fork-hook: project-windows/updates-harness-window-get
121+
get: () => Effect.succeedNone, // fork-hook: multi-window/updates-harness-window-get
122122
getById: () => Effect.succeedNone, // fork-hook: multi-window/window-id-get-by-id
123123
getOrCreate: () => Effect.die("unexpected identity window creation"), // fork-hook: multi-window/updates-harness-window-get-or-create
124124
createNew: () => Effect.die("unexpected new window creation"), // fork-hook: multi-window/dispatch-create-new

‎apps/web/src/index.css‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
/* Clerk injects its component styles into the clerk layer (clerkAppearance.cssLayerName). */
22
@layer theme, base, clerk, components, utilities;
33
@import "tailwindcss";
4-
@import "./index.fork.css"; /* fork-hook: project-windows/index-fork-css */
4+
@import "./index.fork.css"; /* fork-hook: fork-meta/index-fork-css */
55

66
@custom-variant dark (&:is(.dark, .dark *));
77
@custom-variant light (&:not(.dark, .dark *));

‎apps/web/src/index.fork.css‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
/* Fork-only stylesheet, imported once from index.css behind the marked hook
2-
`project-windows/index-fork-css`. Fork rules live here as cascade overrides;
2+
`fork-meta/index-fork-css`. Fork rules live here as cascade overrides;
33
index.css follows upstream text. Overrides use bumped specificity because the
44
imported sheet precedes the upstream rules it beats. */
55

‎docs/user/keybindings.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -166,6 +166,7 @@ through the pages you have visited, like a browser's back and forward buttons.
166166
`window.openProject` focuses the active project's desktop window, or opens one when it has none, and defaults to `mod+alt+o`.
167167
It was named `project.openWindow`, then `window.openInNew`; a saved binding with either old name keeps working.
168168
Both window commands and their keybindings are shown only in the desktop app.
169+
`projectFilter.choose` opens the window's [project chooser](./thread-sidebar.md#choose-a-windows-projects) and defaults to `mod+alt+f`.
169170

170171
`terminal.focus` moves focus into the thread terminal drawer, opening it if needed.
171172
`chat.focusComposer` moves focus back to the composer without closing the drawer. Both default to

‎docs/user/thread-sidebar.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -238,6 +238,15 @@ A window opened on a project starts with its project filter set to that project;
238238
Links saved from older project windows still open the same thread, draft, or list.
239239
Web and mobile clients do not show project-window actions.
240240

241+
### Choose a window's projects
242+
243+
Each window keeps its own project filter; an empty filter shows all projects.
244+
Open the project chooser at the top of the sidebar, **Choose projects** in the command palette, or press `mod+alt+f`.
245+
The project label on Issues and Pull requests opens it too.
246+
Select several projects, or **All projects** to clear the filter.
247+
A project's **Show only** button narrows the window to that project.
248+
On web the filter belongs to the browser tab, and on mobile to the device.
249+
241250
## Inspect agent work
242251

243252
**Limited** means the provider stopped on a usage or rate limit. The conversation

0 commit comments

Comments
 (0)