{"id":50507627,"url":"https://github.com/xcodebuild/agent-status-cli","last_synced_at":"2026-06-02T17:31:00.117Z","repository":{"id":351434576,"uuid":"1210646757","full_name":"xcodebuild/agent-status-cli","owner":"xcodebuild","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-22T09:58:56.000Z","size":170,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-22T11:37:30.798Z","etag":null,"topics":[],"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/xcodebuild.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-04-14T16:08:30.000Z","updated_at":"2026-04-22T09:57:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/xcodebuild/agent-status-cli","commit_stats":null,"previous_names":["xcodebuild/agent-status-cli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/xcodebuild/agent-status-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xcodebuild%2Fagent-status-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xcodebuild%2Fagent-status-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xcodebuild%2Fagent-status-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xcodebuild%2Fagent-status-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xcodebuild","download_url":"https://codeload.github.com/xcodebuild/agent-status-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xcodebuild%2Fagent-status-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33833277,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"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":[],"created_at":"2026-06-02T17:30:59.351Z","updated_at":"2026-06-02T17:31:00.110Z","avatar_url":"https://github.com/xcodebuild.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# agent-status-cli\n\n`agent-status-cli` 把 Claude Code 和 Codex 的当前状态同步到终端标签页标题和颜色上。\n\n\n`agent-status-cli` syncs Claude Code and Codex status to terminal tab titles and colors. \n\n\n---\n\n[中文说明](README_CN.md)\n\n## Quick Start\n\nInstall the latest release:\n\n```bash\ncurl -fsSL https://gh-proxy.com/https://raw.githubusercontent.com/xcodebuild/agent-status-cli/master/install.sh | sh\n```\n\nQuick examples:\n\n```bash\nasc-codex\nasc-claude\n```\n\nPreview:\n\nShown in iTerm2 with `Tab bar location` set to `Left`.\n\n![agent-status-cli preview](https://img.cdn1.vip/i/69df1fd6627b6_1776230358.webp)\n\nShown in kitty.\n\n![agent-status-cli preview kitty](https://img.cdn1.vip/i/69e04ac1bb0df_1776306881.webp)\n\n## Recommended kitty config\n\n`allow_remote_control yes` is required. `agent-status-cli` uses kitty remote control to update tab colors.\n\nAdd this to `kitty.conf`:\n\n```conf\nallow_remote_control yes\ntab_bar_min_tabs 1\nfont_size 16.0\nfont_family JetBrainsMono Nerd Font, Sarasa Mono SC, Noto Sans CJK SC\nadjust_line_height 125%\n\nmap cmd+t\nmap cmd+enter\nmap cmd+n\n\nmap cmd+t launch --type=tab --cwd=current\nmap cmd+enter launch --type=window --cwd=current\nmap cmd+n launch --type=os-window --cwd=current\n\nmap cmd+shift+left previous_tab\nmap cmd+shift+right next_tab\n```\n\n## Commands\n\nThe project ships three executables:\n\n- `agent-status-cli`: generic wrapper, choose the tool with `--asc-tool`.\n- `asc-codex`: fast path for `codex`; all following arguments are passed through.\n- `asc-claude`: fast path for `claude`; all following arguments are passed through.\n\nExamples:\n\n```bash\nagent-status-cli --asc-tool codex\nagent-status-cli --asc-tool claude resume --continue\n\nasc-codex --model gpt-5\nasc-codex exec \"fix the failing test\"\nasc-codex --asc-title-map ready=✅\n\nasc-claude\nasc-claude resume --continue\n```\n\nWrapper options are now the arguments prefixed with `--asc-`. Everything else is passed through to `codex` or `claude` unchanged. If you want to stop wrapper parsing explicitly, use `--`:\n\n```bash\nagent-status-cli --asc-tool codex --asc-title-map ready=✅ --model gpt-5\nagent-status-cli --asc-tool codex -- --help\n```\n\n## Behavior\n\n- Status is inferred from the wrapped CLI screen output.\n- Tab titles are updated through OSC title sequences.\n- Tab colors are updated automatically in iTerm2 and kitty.\n- iTerm2 uses OSC 6 tab color sequences and applies the active-tab color.\n- kitty uses `kitten @ set-tab-color --self`; `allow_remote_control yes` is required, and when `KITTY_LISTEN_ON` is available it uses `--to` automatically. The active tab uses the state color and the inactive tab uses an automatically dimmed variant of that same color.\n- If another terminal supports iTerm2-compatible OSC 6 tab colors, use `--asc-color-mode on` to force emission manually.\n- `--asc-keep-alt-screen` is kept as a compatibility no-op; the wrapper currently preserves the wrapped CLI screen behavior as-is.\n\nDefault state mappings:\n\n- `starting` -\u003e `⏳`\n- `busy` -\u003e `⚙️`\n- `ready` -\u003e `🟢`\n- `error` -\u003e `🔴`\n\n## Release Artifacts\n\nGitHub Actions builds zip artifacts for:\n\n- `x86_64-unknown-linux-gnu`\n- `x86_64-apple-darwin`\n- `aarch64-apple-darwin`\n\nPushes to `main` or `master` update a rolling `latest` GitHub Release with those zip files, which is what `install.sh` downloads by default.\n\nTagged pushes like `v0.1.0` also publish versioned GitHub Releases so you can install a pinned build:\n\n```bash\ncurl -fsSL https://gh-proxy.com/https://raw.githubusercontent.com/xcodebuild/agent-status-cli/master/install.sh | sh -s -- v0.1.0\n```\n\n## Development\n\nRun tests:\n\n```bash\ncargo test\n```\n\nShow help:\n\n```bash\ncargo run -- --asc-help\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxcodebuild%2Fagent-status-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxcodebuild%2Fagent-status-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxcodebuild%2Fagent-status-cli/lists"}