History

History (⌘7) is the Git log of your ledger, with a diff viewer. The subtitle shows the branch: on main (or detached HEAD).

The three panes

Commits (left). Newest first: the message, the short hash and how long ago. Hover for the author and the exact date. Older commits load as you scroll down.

At the top, when there is something uncommitted, an orange Uncommitted Changes row with the number of files. Select it to see what you have changed since the last commit.

Files (top right). The files touched by the selected commit, each with a letter:

Letter	Meaning
A green	Added
M orange	Modified
R orange	Renamed
D red	Deleted
? green	New, not yet tracked (in Uncommitted Changes)
U purple	In conflict

Diff (bottom right). What changed in the selected file, with Beancount syntax highlighting: removed lines in red, added lines in green.

Drag the dividers to resize the panes.

Toolbar

• Side by Side switches the diff between two columns (before | after) and a single inline column.
• Commit… (⌥⌘C) commits everything that is uncommitted; see Committing by hand.

History refreshes on its own when the repository changes, including commits you make from Terminal.

What it is for

• “What did I change last week?” Select the commits and read the diffs.
• Reviewing an import from the iPhone. It arrives as one commit; its diff is every transaction that was added.
• Checking before committing. Uncommitted Changes shows what would go in.

History is for looking. Reverting, branching, pushing and the rest are left to Git itself — and since the app uses the standard repository in your ledger’s folder, any Git tool works alongside it.

No history yet?

The app starts a history on its own when you open a ledger whose folder has none (see Setting it up). When it did not — the main file was in a subfolder of the folder you chose — this screen says No History Yet and offers Start History: it makes the folder you chose a Git repository, with everything in it as the first commit.