repobs 0.4.0

Added

• Help menu: Help → Legend and controls (also in Search commands) opens one dialog with every mark on the dashboard, the three timeline modes and the mouse and keyboard controls; it replaces the Legend button and bar of each view. The menu also links to the tutorial, the documentation, the GitHub repository, releases and a new issue.

• Tutorial: the user guide's Getting started and Using repobs pages are now a tutorial in five chapters (install and add projects, read the dashboard, follow your agents, review and take notes, arrange your workspace), with screenshots of each step in both themes, made by tests/e2e/docs-tutorial.spec.ts on synthetic data.

• Live wheel zoom: the history is redrawn while you zoom, at most once per frame, keeping the moment under the pointer in place on every axis; each agent's ticks, spans and marks are drawn as a few paths instead of one element each (a large view went from about 19,000 to 7,000 elements, a redraw from about 100 to 50 ms). Zooming a large view can still look jumpy.

• What an agent did: each agent's line is solid where it was working and dotted between, with a tick per tool call; zoom to 300 % or more (or Agents → Activity detail) for its steps on the same line — model time (with thinking), tool calls by kind, failed calls, prompts, compactions, Git changes ◆ and inspections ○. Hover cards and the details panel sum it up a line per field: tools, commands and time as proportional bars (click one for each part's amount, again for its share), then tokens in and out, cache hit rate and current context. Agents → Agent line → Height: context used makes agent lines as tall as their context was full. Agent cards in the lanes open after a 0.5 s pause; the label column opens them at once. An agent active only before the history range shows a ◂ mark at the left edge and its card, instead of an empty lane; a line that began before the range starts with ◂ instead of being cut flat with its earlier steps piled at the edge. Counted on demand from the agents' own files; only tool names, allowlisted command names, times, outcomes and token counts are kept, in memory (ADR 0013). Settings → Privacy → Read agents’ activity turns it off.

• Folders without Git: add a folder to see the Claude Code and Codex agents working in it on the shared timeline, under one Folder row with no commits (ADR 0011). Add suggests session working directories outside Git as folders; a typed path that Git does not recognise offers Add as folder. Registered repositories inside a folder keep their own agents. Drive roots, your home folder and folders inside a repository are refused. repobs reads nothing in a folder beyond whether it exists, and reports a folder that became a Git repository without converting it. Upgrading migrates the database to schema v4 (backed up first); 0.3.0 cannot read it.

• A 25-second product film (an animated illustration, with sound) that opens the documentation landing page. It plays by itself, muted, without player controls, and the page waits for it; trying to scroll offers Skip, which fades it out and shows the title, as its end does. Scrolling back up plays it again. The page waits only once per session; the film starts by itself whatever the motion preference.

• The documentation landing page is a product page, in the manner of energyatlas.io: it opens on the film, full window; the header, the product name, a serif tagline and the buttons appear as the page scrolls; then feature rows with real screenshots (rounded, with a glow) and hand-drawn icons, privacy, documentation cards and a closing call to action. No frame, strips or tabs on that page; the header shows section links instead (ADR 0007, amended).

• Interface size (ADR 0010): Ctrl + mouse wheel, Ctrl + = / − / 0 or View → Styling make the whole interface larger or smaller in 10 % steps (50–200 %), in place of the browser's zoom. It is kept per browser; the status bar shows it when it is not 100 % and resets it on click.

Changed

• The mouse wheel over the dashboard zooms the history around the pointer, 10 % per notch (it was Ctrl + wheel), instead of scrolling; drag to move through it. Sideways swipes on a touchpad and Shift + wheel still scroll sideways. Text in the dashboard can no longer be selected, so a drag never selects.
• The documentation site takes the shape of the EnergyAtlas documentation sites: two parts (User guide, Developer), each with an index page in reading order; a landing page with a serif italic line in the headline, two cells and fewer sections; the tab bar and section strips on the page's own surface (ADR 0007, amended).
• The demo repositories have realistic names (git-status-kit, storefront-web), and the overview screenshot shows the dashboard alone, without side panels or legend.
• Notices (a repository removed, a refresh, a file opened, a failed action, a lost connection) float above the status bar instead of pushing the workbench down. A confirmation leaves by itself after 8 seconds, but not while the pointer or focus is on it; a failure stays until dismissed.
• Every screenshot also comes in the dark theme: the landing page and the README show the one matching the reader's theme.

Fixed

• Agents showed Needs input while a tool was simply running (a test run, a build, a long command). Only an explicit question now needs you: Claude Code's AskUserQuestion or ExitPlanMode, or Codex's blocking request_user_input. A running tool shows Working, with tool running or awaiting permission only where the session can prompt for permission.
• Commit order and Calendar, compressed stacked the agents of a folder without Git at one point, and squeezed agents that ran before the first commit or between two distant commits into one gap. Each agent's first and last activity now takes its own place on those axes, like a commit (ADR 0003, amended).
• Codex history: most Codex threads were missing, because Codex 0.166 compresses older rollouts (rollout-*.jsonl.zst) and repobs read only plain ones. Compressed rollouts are now read in memory, over the first scans after start, with the same state, excerpt and plan rules. Codex's state_5.sqlite thread index is read read-only for thread names and lists threads without a readable rollout as Unknown · only thread metadata is available; it never reads prompt columns and never creates files or takes blocking locks in the Codex home (ADR 0012). Codex working directories lose their \\?\ prefix.
• A forked Codex sub-agent's rollout was credited to its parent thread, whose session_meta it repeats after its own; the sub-agent now appears as its own session.
• A Claude Code session whose last reply is a failed API call (a run that could not sign in, a rate limit, a server error) showed as Idle / turn finished; it now shows Error, inferred from the transcript, until the next prompt. The same applies to subagents.
• Claude Code task plans using TaskCreate and TaskUpdate now appear in agent checklists. Successful results supply task ids and confirmed changes; long-transcript and subagent recovery preserves earlier task creations.
• After closing a side panel from the toolbar, its button stayed pressed until something else redrew the page.
• Browse… in Add repositories could appear to do nothing: the legacy folder dialog sometimes closed itself as Cancel within two seconds, and any failure was also reported as a cancel. It now uses the Windows shell folder dialog, opens in front on the monitor where you clicked, and every outcome shows in the page: the chosen folder, closed without choosing a folder, or the error. While it is open the page says so and offers Stop waiting, which closes it.

Install

1. Install Node.js 24 LTS (24.11 or newer) and Git for Windows.
2. Download repobs-0.4.0.zip below and unzip it.
3. In the unzipped repobs-0.4.0 folder run npm start (or powershell -ExecutionPolicy Bypass -File scripts\start.ps1).

No install or build step and no downloads: the zip holds the built app and its one runtime dependency. Your annotations live in %LOCALAPPDATA%\repobs, so a new release can replace the folder. To build from source instead, use the source archive and the README.

SHA-256 of repobs-0.4.0.zip: 607ee1ec0da4280b32e1a019c6e881d222e49db2e6edcca4867d17d31299d7a1