Agent Ledger support
Help with installing Agent Ledger, connecting the Chrome extension, and reading what it recorded.
Get help
Open an issue on GitHub with what you expected and what happened. The output of ledgerctl status helps: it lists the app's connections and recent hook activity without any browsing data.
Please don't attach a session export unless you've read it first. Exports contain the pages and field values that were recorded.
Common questions
- The toolbar icon shows an orange "!"
- The extension can't reach the Mac app. Make sure Agent Ledger is running (it lives in the menu bar). Hover over the icon to see Chrome's exact error. If it says the native host wasn't found, open Settings → Integrations, click Register native host, then quit and reopen Chrome.
- Nothing is being recorded
- That's by design until an agent works in a tab: ordinary browsing is never recorded. Start a browser task in Claude Code or Codex and the tab's icon shows REC. Installing the hooks in Settings → Integrations makes detection immediate and lets the ledger name the agent.
- The extension disappeared after restarting Chrome
- A copy loaded with Load unpacked only stays installed while Developer mode is on in chrome://extensions. Turn it back on and load the folder again, or install the extension from the Chrome Web Store, which doesn't need Developer mode.
- Codex activity isn't showing up
- Codex asks you to approve new hooks the first time. Approve the Agent Ledger hooks under Codex's hook review. Codex controls Chrome from the ChatGPT app; the codex command-line tool can't reach Chrome.
- Why does it say Likely Codex instead of Identified?
- Codex reports each browser call but not which tab it acted on, so the ledger can confirm the session but not tie each action to a tab. Claude Code reports the tab, so its actions are usually Identified.
- Something I did is labeled as the agent's
- Right-click the row in the Ledger window and choose This was me, or use That was me in the menu bar for the last two minutes. Corrections are stored separately; the original observation is never rewritten.
- How do I update?
- The app checks for updates once a day. Use Check for Updates in the menu bar or in Settings to check now.
- How do I delete my data or uninstall?
- Remove the hooks and native host in Settings → Integrations (or with ledgerctl uninstall-hooks and ledgerctl uninstall-host), remove the extension in chrome://extensions, quit the app, and delete ~/Library/Application Support/AgentLedger. Sessions are also deleted automatically after the retention period you choose.
Agent Ledger keeps everything on your Mac and sends nothing to me or to any server. Read the privacy policy.