Agent Trail
Which agent touched this project last, and which one needs you now?
A read-only macOS menu-bar app. Each Git repository gets one card across Claude, Codex, Grok, GitHub Copilot, OpenCode, and Cursor: which agent edited it last, history from the logs already on your Mac, and which live session needs you. When Claude says a session is idle but a command it started is still running, the card says Working in background.
Works with Claude Code in Claude Desktop's Code tab and claude in a terminal, Codex, Grok, GitHub Copilot (Copilot Chat in VS Code, and the Copilot CLI), OpenCode (the terminal, the desktop app, and opencode serve), and Cursor (agent chats in the Cursor app, and Cursor CLI sessions). A Codex thread waiting for approval shows as Working, and so does an OpenCode session waiting to approve a shell command or a subagent; OpenCode file approvals show as Needs input. Copilot Chat in VS Code and Cursor CLI sessions have history but no live status; Cursor app chats show live status (Cursor 3.29 and later). Not supported: Gemini CLI. It can't answer prompts for you.
Private by design: no network, no account, no telemetry, no hooks. It never writes to your assistants' files.
0.1.0-alpha.14 · Public alpha · macOS 14+ · MIT license · Changelog · Website
Long jobs stay visible. When Claude starts a training run, a long build, or an evaluation sweep in the background and ends its turn, Claude reports the session as idle. Agent Trail sees that the session's own command is still running and shows it as Working in background until the job ends, so a quiet window never hides a run in progress. How it works
Sample data. Project names, profiles, paths, and counts in these previews are synthetic.
Install
Download Agent-Trail-macOS-universal2.zip from the 0.1.0-alpha.14 release, not the "Source code" archives: one app for Apple Silicon and Intel Macs on macOS 14 or later.
- Unzip it and move Agent Trail to your Applications folder.
- Open it. This alpha is ad-hoc signed and not Apple-notarized, so macOS stops the first launch. Close the warning without choosing Move to Trash. Within the next hour, open System Settings › Privacy & Security, click Open Anyway next to the Agent Trail message, then confirm with Open Anyway (Open on macOS 14) and your login password. You do this once per release. On macOS 14 you can instead Control-click the app, choose Open, and click Open again.
To skip the warning, run xattr -dr com.apple.quarantine "/Applications/Agent Trail.app" in Terminal before the first launch. To check the download before you open it, keep the ZIP and its .sha256 file in one folder, go to that folder in Terminal (for example cd ~/Downloads), and run shasum -a 256 -c Agent-Trail-macOS-universal2.zip.sha256; it prints Agent-Trail-macOS-universal2.zip: OK. Safari may unzip the download and move the ZIP to the Trash; choose Put Back there to restore it for this check.
Build from source with Swift 6+, using Xcode or the Command Line Tools, from the repository folder:
./scripts/build-app.sh
open "dist/Agent Trail.app"
A local build opens without the warning. To keep it, copy dist/Agent Trail.app to your Applications folder. Development covers tests and other build options.
Why it exists
Two assistant instances. The same project open in both. Different worktrees, conversations, and changes. Returning to work should not begin with guessing which window has the latest context.
Agent Trail leaves each agent in its own app. It doesn't start, wrap, or drive any assistant, and it never touches your sign-ins. Claude keeps running in Claude Desktop or your terminal, Codex in Codex, Grok in its terminal, Copilot in VS Code or its terminal, OpenCode in its terminal or desktop app, and Cursor in its app or terminal, each with its vendor's newest features. Agent Trail reads what they already record and takes you back to the right one. If Agent Trail stops working, your agents don't notice.
Agent Trail shows each project once, bringing its reported live sessions together with the last recorded edit and latest saved activity where history is available. A project is the Git checkout where an assistant's confirmed edits actually landed, so Claude, Codex, Grok, Copilot, OpenCode, and Cursor working in the same repository share one card even when they were started in different folders. A Claude worktree stays connected to that original folder, and a repository you move keeps its history.
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
