Skip to content
/ Lab

Zeigarnik · macOS · Open source

See what you left unfinished.

A macOS app that shows, day by day, what is going on across your git repositories: when you last worked on each one with Claude Code, Codex or a commit, what is uncommitted or unpushed, whether the README has fallen behind the code, and how far each spec or plan really got.

Download for macOS Install steps

macOS 14+ · Apple Silicon and Intel · Signed, not notarized · Free, MIT licensed.

One list, every repository

Choose the folders that hold your repositories. Zeigarnik scans the git repositories inside them and keeps one row per project, with the facts you would otherwise collect by hand from git status, agent logs and your notes.

Zeigarnik list view: a sidebar with views, attention filters and folders, and a table of ten projects with last activity, last commit, dirty files, unpushed commits, README drift, estimated time and spec progress.
List view. Demo data: ten made-up projects. Attention filters count uncommitted work, push problems, README or architecture drift and quiet projects.

What it shows

A project, a day

Select a project to see its facts, 14 days of activity and spec tasks with evidence. Switch to the calendar to see which projects you touched each day, with notes and scheduled follow-ups.

Zeigarnik project inspector beside the list: path, open buttons, last activity, branch, dirty files, unpushed commits, README and architecture drift, estimated time, a 14-day activity chart and four spec tasks, two of them done.
Project inspector. Spec progress is counted from evidence in paths and commits; you can also mark tasks done by hand.
Zeigarnik calendar month view with projects worked on each day, estimated time per project, notes and scheduled follow-ups, and a day panel listing the day's projects, sessions and a note.
Calendar and day panel. Each day lists the projects you worked on, with estimated time, notes and scheduled follow-ups that also land in macOS Calendar.

Stays on your Mac

  • Everything is stored on your Mac, in ~/Library/Application Support/Zeigarnik/.
  • From agent logs only the agent, session id, timestamp, working directory and source are stored, never prompt or message text.
  • Credentials in remote URLs are stripped before anything is stored.
  • Network access is git fetch and, while the visibility check is on, one question per repository to GitHub or GitLab (through gh when installed). No telemetry. Turn the visibility check off in Settings > Checks.

Install

Requires macOS 14 or later. One download runs on Apple Silicon and Intel and carries the zeigarnik command-line tool inside.

  1. Download Zeigarnik-<version>-macos.zip from the latest release.
  2. Unzip it and move Zeigarnik.app to /Applications.
  3. The app is signed but not notarized, so macOS blocks the first launch. Open it once, then choose Open Anyway in System Settings > Privacy & Security, or clear the download flag with the command below.
  4. On first launch, a welcome window asks for the folders that hold your repositories. Zeigarnik reads only git repositories inside the folders you choose.
xattr -dr com.apple.quarantine /Applications/Zeigarnik.app

macOS asks for access to your Documents folder, to iCloud Drive if your folders or vault live there, and to Calendars when you turn on scheduling. Each feature degrades visibly when access is denied. Every release is signed with the same certificate, so macOS keeps these answers across updates.

Build from source

Requires macOS 14 or later, Xcode 16 or later (Swift 6), and xcodegen to regenerate the project after adding or removing files. Open the project, choose the Zeigarnik scheme, then Run, or build from the command line.

From Xcode

git clone https://github.com/ceaksan/zeigarnik.git
cd zeigarnik
open Zeigarnik.xcodeproj

From the command line

xcodebuild -project Zeigarnik.xcodeproj -scheme Zeigarnik -configuration Release -derivedDataPath build build
open build/Build/Products/Release/Zeigarnik.app

Sign the build with your own development certificate and macOS remembers its permission answers across rebuilds; an unsigned or ad-hoc signed build asks again after each rebuild.

Optional integrations

None of these are required; Zeigarnik uses what it finds.

IntegrationWhat it adds
Claude Code and CodexActivity and time come from ~/.claude and ~/.codex. If you do not use one of them, nothing is shown for it.
Project tableA Markdown table in CLAUDE.md at the top of your first folder can name projects and point to directories outside your folders.
Numbered foldersSubfolders named like 01_Core or 02_Products become sidebar folder groups.
Specs and plansDesign specs and implementation plans, for example under docs/superpowers/ or OpenSpec, are read for task progress, with evidence from paths and commits.
Obsidian vaultPoint Settings at a vault to show open Active Tasks counts per project.
herdrWith hc installed, projects open in a herdr pane are marked live and can be opened in herdr.
ghWith the GitHub CLI installed and signed in, the visibility check also works for your private repositories.

Command line and MCP

The app ships the zeigarnik command, which reads and writes the app's notes in the same database. Put it on your PATH once:

ln -s /Applications/Zeigarnik.app/Contents/Helpers/zeigarnik ~/.local/bin/zeigarnik
zeigarnik projects
zeigarnik status <project>
zeigarnik notes list --project <project>
zeigarnik notes add --project <project> "Release after the review"
zeigarnik drafts

A project is named by its id, display name or path, and every read command takes --json. zeigarnik mcp runs an MCP server that lists projects, reads project status and lists, reads, adds and edits notes. There is no delete tool. To add it to Claude Code:

claude mcp add zeigarnik -- ~/.local/bin/zeigarnik mcp

Built from source, the scanner also runs without the app and writes to the same database. --root is required and may be repeated; --db points at another database file.

swift run zeigarnik-scan --root ~/Projects --no-fetch
swift run zeigarnik-scan --root ~/Projects --vault ~/Vault --json

Why the name

Zeigarnik is named after the Zeigarnik effect: unfinished tasks are remembered better than finished ones. The app writes them down, so you do not have to keep them in your head.

Zeigarnik is free and open source under the MIT license. Read the source and README for the current behavior, tests and architecture.