Skip to main content

Getting Started

CLI agents are replacing IDEs — but they leave no trace of which prompt caused which change. NoCrumbs fills that gap. A lightweight CLI hook + native Mac app that links every prompt to the commits it produced. Install once, forget about it.

Requirements: macOS 14+, Xcode 15+ (to build from source)

Install​

brew install geneyoo/tap/nocrumbs

This installs both the Mac app and the nocrumbs CLI.

From source​

# 1. Clone & build the Mac app
git clone https://github.com/geneyoo/nocrumbs.git && cd nocrumbs
xcodebuild -project NoCrumbs.xcodeproj -scheme NoCrumbs -configuration Release \
  -sdk macosx -derivedDataPath build build CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO
open build/Build/Products/Release/NoCrumbs.app

# 2. Build & install the CLI
swift build -c release --package-path CLI/
cp CLI/.build/release/nocrumbs /usr/local/bin/

Configure Hooks​

Run these once after installing:

# Register Claude Code hooks (~/.claude/settings.json)
nocrumbs install

# Install git commit annotation hook (run in each repo)
nocrumbs install-git-hooks

nocrumbs install writes hook entries to your Claude Code config so prompts and file changes are captured automatically. nocrumbs install-git-hooks adds a prepare-commit-msg hook that annotates your commits with prompt context.

Verify​

  1. The NoCrumbs icon appears in your menu bar
  2. Open a Claude Code session and send a prompt
  3. Open the NoCrumbs window — your prompt and file changes should appear in the sidebar

Next Steps​