anywhere-agents

Install the anywhere-agents AI agent config into any project, in one command.

pipx install anywhere-agents
anywhere-agents                          # bootstrap shared config + hooks + settings
anywhere-agents pack add <pack-repo-url>  # add a pack (one-shot: fetch, install, deploy)

Or zero-install for one-off bootstrap:

pipx run anywhere-agents

Why pipx, not pip? anywhere-agents is a CLI tool with its own dependencies. Plain pip install either lands in the active venv (per-project, not per-machine) or hits PEP 668 / externally-managed-environment errors on modern Ubuntu / Debian / Homebrew Python. pipx gives each CLI tool its own isolated venv and exposes the binary on PATH globally; it is the PyPA-recommended approach for Python CLI applications. uv tool install anywhere-agents works equivalently.

What it does

Runs the shell bootstrap from the upstream repo in the current directory:

Fetches AGENTS.md and replaces the local copy
Sparse-clones the upstream repo into .agent-config/
Syncs the six shipped skills (implement-review, my-router, ci-mockup-figure, readme-polish, prun, editable-figure) and their Claude Code command pointers. Completing an editable-figure PPTX deliverable requires desktop PowerPoint on Windows or macOS; its bundled export script is Windows-only.
Deep-merges project-level .claude/settings.json
Deploys the safety guard hook to ~/.claude/hooks/guard.py and the Claude Max + Codex quota statusLine to ~/.claude/statusline.py, and merges user-level permissions
Adds .agent-config/ to .gitignore

After bootstrap, every Claude Code session shows your live Claude Max + Codex 5h / weekly quota at the bottom of the terminal:

🤖 Opus 4.8 · 5h 78% (3h 4m) · 7d 51% (15h 4m)  |  Codex 5h 89% (3h 25m) · 7d 90% (4d 23h)

Bootstrap logic lives in the shell bootstrap scripts at yzhao062/anywhere-agents/bootstrap/; the Python CLI invokes them so that agents and users in a Python-first workflow can run the same mechanism without reaching for curl. Pack management (pack add | remove | verify | list | update) and uninstall are implemented directly in the Python CLI.

Options

anywhere-agents             # run bootstrap in cwd (default)
anywhere-agents --dry-run   # print what would happen without fetching or executing
anywhere-agents --version

Requirements

Python 3.9+
bash on macOS/Linux, PowerShell (pwsh or powershell) on Windows
git available on PATH (used by the bootstrap scripts to sparse-clone the upstream repo)

Documentation and source

The real content lives in the GitHub repo: https://github.com/yzhao062/anywhere-agents

README — quickstart and benefits
CHANGELOG
Issues

License

Apache 2.0.

Metadata

Release files for anywhere-agents 0.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for anywhere-agents 0.9.0
File	Size	Uploaded
anywhere_agents-0.9.0.tar.gz	481.6 kB	Sep 18, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for anywhere-agents 0.9.0
File	Interpreter	ABI	Platform	Reset
anywhere_agents-0.9.0-py3-none-any.whl 556.5 kB Sep 18, 2026	Python 3	none	any	Details

Total release size: 1.0 MB

Release files / anywhere_agents-0.9.0.tar.gz

Download URL	anywhere_agents-0.9.0.tar.gz
Size	481.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`1c27e28f4aa0a4735e3b8366b7812364ac39c44aaf01174d7bdb541da87ba165`
BLAKE2b-256 checksum How to use checksums	`be868fff10dc82eb3ce84cc0d080addf6da6acbc96eecfe5cf1a56efd674bf3a`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/yzhao062/anywhere-agents
Publishing commit: github.com/yzhao062/anywhere-agents/tree/3343cd3255474aadf0419d42d7a15d28caa785a6

Workflow

Publishing configuration: github.com/yzhao062/anywhere-agents/blob/3343cd3255474aadf0419d42d7a15d28caa785a6/.github/workflows/publish.yml
Publishing logs: github.com/yzhao062/anywhere-agents/actions/runs/35309182403/attempts/1

Artifact

Subject: anywhere_agents-0.9.0.tar.gz
SHA-256 checksum: 1c27e28f4aa0a4735e3b8366b7812364ac39c44aaf01174d7bdb541da87ba165 Verifying attestations

Release files / anywhere_agents-0.9.0-py3-none-any.whl

Download URL	anywhere_agents-0.9.0-py3-none-any.whl
Size	556.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`328febae09d2e942b028e81af5542b2b936858c3ab230031b612b4f018e6badc`
BLAKE2b-256 checksum How to use checksums	`00787b0bd9a1b3c4258a495fcc996f1533e2c04756bac8391bd9b54deb4044ed`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/yzhao062/anywhere-agents
Publishing commit: github.com/yzhao062/anywhere-agents/tree/3343cd3255474aadf0419d42d7a15d28caa785a6

Workflow

Publishing configuration: github.com/yzhao062/anywhere-agents/blob/3343cd3255474aadf0419d42d7a15d28caa785a6/.github/workflows/publish.yml
Publishing logs: github.com/yzhao062/anywhere-agents/actions/runs/35309182403/attempts/1

Artifact

Subject: anywhere_agents-0.9.0-py3-none-any.whl
SHA-256 checksum: 328febae09d2e942b028e81af5542b2b936858c3ab230031b612b4f018e6badc Verifying attestations