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 shipped skills (implement-review, my-router) 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.7 · 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.6.1.tar.gz (257.2 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.6.1-py3-none-any.whl (291.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: anywhere_agents-0.6.1.tar.gz
  • Upload date:
  • Size: 257.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for anywhere_agents-0.6.1.tar.gz
Algorithm Hash digest
SHA256 407f90a8927fb5ab2bf253542767be8b280ba44327ba16dfb381b5175369a570
MD5 a15eea541639634e36b11a4cd0bc051d
BLAKE2b-256 f92e64ab2794c7e344f3e1597d35a73fe6938606e6c6ca07fd4b7152d2a99ebe

See more details on using hashes here.

File details

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

File metadata

  • Download URL: anywhere_agents-0.6.1-py3-none-any.whl
  • Upload date:
  • Size: 291.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for anywhere_agents-0.6.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7028ccb719076e47939f6037146e5e08869ca36181b8991a938be51a2dd48661
MD5 0001b04dbeeae1f5214fe456b6b3ab60
BLAKE2b-256 c355212ec9cb45a6ad1cdbe590dc8e59ff129763f48a212eae59236e36d767c3

See more details on using hashes here.

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