Skip to main content

Install the anywhere-agents AI agent config (AGENTS.md, skills, guard hook, settings) into any project.

Project description

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 five shipped skills (implement-review, my-router, ci-mockup-figure, readme-polish, prun) and their Claude Code command pointers
  • 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

License

Apache 2.0.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

anywhere_agents-0.7.8.tar.gz (304.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

anywhere_agents-0.7.8-py3-none-any.whl (357.4 kB view details)

Uploaded Python 3

File details

Details for the file anywhere_agents-0.7.8.tar.gz.

File metadata

  • Download URL: anywhere_agents-0.7.8.tar.gz
  • Upload date:
  • Size: 304.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for anywhere_agents-0.7.8.tar.gz
Algorithm Hash digest
SHA256 9f9cd2e166bfac8dd138ed9939dc32354e84387346dec4df395706bc63851c5d
MD5 4ce25b5cf11c38198497b8714df46896
BLAKE2b-256 636f4b281e5c3781d9dc0d188945498d7e9d295f7aa5672ed1ca52356b05a3f1

See more details on using hashes here.

Provenance

The following attestation bundles were made for anywhere_agents-0.7.8.tar.gz:

Publisher: publish.yml on yzhao062/anywhere-agents

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file anywhere_agents-0.7.8-py3-none-any.whl.

File metadata

  • Download URL: anywhere_agents-0.7.8-py3-none-any.whl
  • Upload date:
  • Size: 357.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for anywhere_agents-0.7.8-py3-none-any.whl
Algorithm Hash digest
SHA256 ce908a88b8d94647793e8186a64acc43811a654d56b3d1f26f60da16cddbb0d2
MD5 4f425a5e852f3961c33a80d4092ec057
BLAKE2b-256 bcbbb166b6f7f1419a792672f32ce9435883c59e8d911dc1e1e8c9f167b8a589

See more details on using hashes here.

Provenance

The following attestation bundles were made for anywhere_agents-0.7.8-py3-none-any.whl:

Publisher: publish.yml on yzhao062/anywhere-agents

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page