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.8.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.8.0
File	Size	Uploaded
anywhere_agents-0.8.0.tar.gz	449.5 kB	Sep 11, 2026	Details

Built distribution (wheel)

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

Total release size: 970.6 kB

Release files / anywhere_agents-0.8.0.tar.gz

Download URL	anywhere_agents-0.8.0.tar.gz
Size	449.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`36999422c9f6dfa5d2cd5a2306d00181b5740c7e450ee926dbae4dc0653d5176`
BLAKE2b-256 checksum How to use checksums	`6db4346d0ec6d4456c3fc32af42a4351912fcfe120432c8976e5667e1856b4c0`
Upload date	Sep 11, 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/7782f0e3352fe26cfe575378cfb3de38e9221b66

Workflow

Publishing configuration: github.com/yzhao062/anywhere-agents/blob/7782f0e3352fe26cfe575378cfb3de38e9221b66/.github/workflows/publish.yml
Publishing logs: github.com/yzhao062/anywhere-agents/actions/runs/34642015547/attempts/1

Artifact

Subject: anywhere_agents-0.8.0.tar.gz
SHA-256 checksum: 36999422c9f6dfa5d2cd5a2306d00181b5740c7e450ee926dbae4dc0653d5176 Verifying attestations

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

Download URL	anywhere_agents-0.8.0-py3-none-any.whl
Size	521.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3d788d27d571fdcd0fe83c924af95eb674102f6f1fccf1da91cdc51cf60e4e57`
BLAKE2b-256 checksum How to use checksums	`9aa04042f0f118016b1c4156d49b4d6eec426cfa1540468f4264478b61ea28c4`
Upload date	Sep 11, 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/7782f0e3352fe26cfe575378cfb3de38e9221b66

Workflow

Publishing configuration: github.com/yzhao062/anywhere-agents/blob/7782f0e3352fe26cfe575378cfb3de38e9221b66/.github/workflows/publish.yml
Publishing logs: github.com/yzhao062/anywhere-agents/actions/runs/34642015547/attempts/1

Artifact

Subject: anywhere_agents-0.8.0-py3-none-any.whl
SHA-256 checksum: 3d788d27d571fdcd0fe83c924af95eb674102f6f1fccf1da91cdc51cf60e4e57 Verifying attestations