{"id":50142618,"url":"https://github.com/zuoxu3310/openagentpeek","last_synced_at":"2026-05-24T02:05:51.477Z","repository":{"id":359882505,"uuid":"1247839041","full_name":"zuoxu3310/openagentpeek","owner":"zuoxu3310","description":"macOS menu-bar app to monitor live Claude Code \u0026 Codex sessions — see which agent is working, idle, or waiting on you, track context usage, and jump to its window.","archived":false,"fork":false,"pushed_at":"2026-05-23T22:56:14.000Z","size":280,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T00:18:09.328Z","etag":null,"topics":["agentic","ai-agents","ai-coding-assistant","claude","claude-code","codex","coding-agent","developer-tools","macos","macos-app","menu-bar","menubar","openai","productivity","react","rust","session-monitor","tauri"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zuoxu3310.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-23T21:12:48.000Z","updated_at":"2026-05-23T22:55:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zuoxu3310/openagentpeek","commit_stats":null,"previous_names":["zuoxu3310/openagentpeek"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/zuoxu3310/openagentpeek","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zuoxu3310%2Fopenagentpeek","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zuoxu3310%2Fopenagentpeek/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zuoxu3310%2Fopenagentpeek/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zuoxu3310%2Fopenagentpeek/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zuoxu3310","download_url":"https://codeload.github.com/zuoxu3310/openagentpeek/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zuoxu3310%2Fopenagentpeek/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33418555,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T22:14:44.296Z","status":"online","status_checked_at":"2026-05-24T02:00:06.296Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic","ai-agents","ai-coding-assistant","claude","claude-code","codex","coding-agent","developer-tools","macos","macos-app","menu-bar","menubar","openai","productivity","react","rust","session-monitor","tauri"],"created_at":"2026-05-24T02:05:50.774Z","updated_at":"2026-05-24T02:05:51.459Z","avatar_url":"https://github.com/zuoxu3310.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OpenAgentPeek\n\nEnglish | [简体中文](README.zh-CN.md)\n\n**See every live Claude Code and Codex session at a glance — and jump straight to the\none that needs you.**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n![Platform](https://img.shields.io/badge/platform-macOS%20(Apple%20silicon)-black)\n![Built with](https://img.shields.io/badge/built%20with-Tauri%202%20%2B%20React-24C8DB)\n\nThe open, free take on AgentPeek — a macOS menu-bar app to monitor every Claude Code and\nCodex session you have running, so you can see at a glance which agent is working, idle, or\nwaiting on you.\n\n![OpenAgentPeek](docs/screenshot.png)\n\n## What it does\n\n- **One glance, every agent.** A menu-bar traffic light — 🟡 a session is *waiting* on you,\n  🔵 something's *working*, 🟢 all *quiet* — with a count of how many aren't idle.\n- **Click to jump.** Click a session and its window comes to the front — the Terminal tab,\n  the VSCode window, or the Codex app it's running in. No more hunting across terminals for\n  the one that's blocked on you.\n- **Context at a glance.** Every session shows how full its context window is.\n- **Both agents, one panel.** Claude Code and Codex, side by side.\n- **Read-only and zero-config.** It only ever *reads* the logs both tools already write —\n  it never touches your sessions, installs no hooks, and needs no setup.\n\n## Why\n\nRun several agents in parallel and *you* become the bottleneck — the human tabbing through\nterminals to find the one that stopped to ask a question. OpenAgentPeek turns that hunt\ninto a glance and a click.\n\n## Install\n\n\u003e macOS, Apple silicon.\n\n**[⬇ Download the latest .dmg](https://github.com/zuoxu3310/openagentpeek/releases/latest)** —\nopen it and drag OpenAgentPeek to Applications.\n\nThe build is **unsigned** for now, so macOS Gatekeeper warns on first open — right-click the\napp → **Open**, or run `xattr -cr /Applications/OpenAgentPeek.app`. The first time you use\nclick-to-jump, macOS asks once for permission to control Terminal.\n\n### Build from source\n\n```bash\nbun install\nbun run tauri build    # needs the Rust toolchain (. \"$HOME/.cargo/env\") + bun\nbun run tauri dev      # …or run it in development\n```\n\n## How it works\n\nTauri 2 (Rust) + React. The backend tails the JSONL transcripts that Claude Code\n(`~/.claude/projects`) and Codex (`~/.codex/sessions`) already write, parses each into a\nstatus + context usage, and pushes a snapshot to the popover once a second. Click-to-jump\nfinds the live process by its working directory and brings its window forward — all by\nobservation, no hooks. Architecture and source map: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).\n\n## Built together\n\nOpenAgentPeek is open source and meant to be built *with* you. It's young — there's plenty\nto shape, and contributions are genuinely welcome:\n\n- **Found a bug or a rough edge?** Open an issue.\n- **Want a feature?** Open an issue first so we can agree on the shape before code.\n- **Sending a PR?** Keep it focused and simple, and make sure `cargo test` passes — see\n  [CONTRIBUTING.md](CONTRIBUTING.md).\n\nGood places to jump in: more terminals for click-to-jump (iTerm2, Ghostty, WezTerm…), a\nthird agent, or design polish in the popover.\n\n## Built with AI\n\nOpenAgentPeek was built almost entirely with Claude Code — the design, the Rust, the React,\nand these docs — as a study in how far agent-driven development goes on a real, shippable app.\n\n## Credits\n\n- Built on the [openusage](https://github.com/robinebers/openusage) stack and visual system.\n- Inspired by AgentPeek's \"see every agent at a glance\" idea.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzuoxu3310%2Fopenagentpeek","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzuoxu3310%2Fopenagentpeek","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzuoxu3310%2Fopenagentpeek/lists"}