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 merges user-level permissions
  • Adds .agent-config/ to .gitignore

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.5.8.tar.gz (216.8 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.5.8-py3-none-any.whl (245.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: anywhere_agents-0.5.8.tar.gz
  • Upload date:
  • Size: 216.8 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.5.8.tar.gz
Algorithm Hash digest
SHA256 9e50b459955fb56cfb954df183f55d740dff8fc16ceddb0c9bab2d30bbefdd2f
MD5 9aba3040ceeedcfe6de637747de43352
BLAKE2b-256 f342ea719b9e9e1a8b990aaf794d3e7f0a2b46c78ba610edbaadf4c9cb87c7a5

See more details on using hashes here.

File details

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

File metadata

  • Download URL: anywhere_agents-0.5.8-py3-none-any.whl
  • Upload date:
  • Size: 245.5 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.5.8-py3-none-any.whl
Algorithm Hash digest
SHA256 95ccd2fa74775e79bee46e32ad5a0c437c270c504e4e68dbd702d034f10a4689
MD5 2c86af74de3d2dd785ece8358ff15427
BLAKE2b-256 8e793b0ece1ddc1b9650b01abfc2287d68de0753aae5e0c47ab489ee9a88bd78

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