Repository navigation
[0.7.0] — 2026-11-14
Added
-
Changed on this branch (desktop). Documents changed on your git
branch show A (added) or M (modified) after their title, in
italics when the change isn't all committed. Changed on this branch
in the filter menu lists only those. A document's hover card shows the
last commit that touched it, and "with Claude" when Claude co-wrote it.
The branch menu's Compare With chooses the branch yours is compared
with, remembered for each repository; a nested repository's folder has it
in its context menu too. The status bar, the hover cards and the filter
name that branch ("feature/x → main", "Changed since main"), and the
status bar names the repository when the workspace holds several. -
Open and reveal files from the document list (desktop). Right-click
a document for Open in Editor, named after your editor (Open in
Visual Studio Code), and Reveal in Finder (Show in Folder on
Windows and Linux). Right-click a folder for Reveal in Finder too. -
What changed since you read it. A changed document opens with a
banner above it: since when, and which sections changed, were added or
were removed, each a link to its section. Mark as Read is there while
it's unread, and the banner stays until you open another document. Folio
keeps the version you last read (in~/.folio/snapshots, compressed) to
compare with, and deletes versions nothing points at any more when it
starts. -
New and changed documents. A dot after a document's title shows it
changed since you read it, and a ring shows it's new. Folders show how
many unread documents they hold, and the Documents tab shows the
total. Unread in the filter menu lists only those. A document counts
as read once it has been on screen for 3 seconds. In the desktop app,
right-click a document for Mark as Read or Mark as Unread, or a
folder for Mark All as Read. The first time you open a workspace,
everything in it counts as read. A version you've read before counts as
read when it comes back, so switching git branches doesn't mark
documents unread. -
Git branches and worktrees (desktop). The status bar shows the branch
of the open document's repository, or the commit when it's detached, and
a worktree icon in a linked worktree. Click it for the repository's
worktrees, to open one as the workspace, and Copy Branch Name. In a
workspace of several repositories, a folder that holds one shows a branch
icon when that repository is off its main branch, and a folder's hover
card names the branch it's on. Folio only reads git; it never changes
anything. -
Marks of documents on another branch are kept apart. After switching
branches, a document that exists only on another branch is listed under
On other branches in the Marks view, not Missing documents: its
marks aren't moved or matched to another document, and they're back when
you switch back. Folio's MCP server leaves them alone too. -
Replies under inline notes. With notes shown in the text (
⌥⌘N/
Ctrl+Alt+N), a note with replies has a line under it: how many, and
who wrote the latest and when, with a New label when there are
replies you haven't read. Click it to read the thread. -
Images open in the whole window, like Mermaid diagrams: hover an
image and click its expand button, or double-click it, to zoom and pan.
The title bar shows the document's title and the image's alt text.
Small images, such as badges, and images inside links don't open.
Changed
-
In a note's replies, the author's name (You, Claude Code) is
bold, so each turn of the conversation stands out. -
A folder's hover card shows its branch as a pill, with a worktree icon
in a linked worktree. A document's hover card sets its change on the
branch apart, with the A or M badge in the list's colours. -
Settings → Review notes is kept in
settings.jsonin the desktop app
(reviewIntroOn,reviewIntro), so Folio's MCP server starts the notes
it gives an agent the same way. What you set in an earlier version is
moved there.
Fixed
- Headings with the same text (an Added under each release) are told
apart: the outline highlights only the one you're reading, and clicking
one goes to it. As on GitHub, repeats get numbered anchors (#added-1).
Full Changelog: v0.6.0...v0.7.0