Metadata-Version: 2.4
Name: anywhere-agents
Version: 0.4.0
Summary: Install the anywhere-agents AI agent config (AGENTS.md, skills, guard hook, settings) into any project.
Author: Yue Zhao
License: Apache-2.0
Project-URL: Homepage, https://github.com/yzhao062/anywhere-agents
Project-URL: Repository, https://github.com/yzhao062/anywhere-agents
Project-URL: Issues, https://github.com/yzhao062/anywhere-agents/issues
Project-URL: Changelog, https://github.com/yzhao062/anywhere-agents/blob/main/CHANGELOG.md
Keywords: ai,agents,claude-code,codex,config,bootstrap,dotfiles,agent-stack
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# anywhere-agents

Install the [**anywhere-agents**](https://github.com/yzhao062/anywhere-agents) AI agent config into any project, in one command.

```bash
pip install anywhere-agents
anywhere-agents
```

Or zero-install:

```bash
pipx run anywhere-agents
```

## 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`

All install logic lives in the shell bootstrap scripts at [`yzhao062/anywhere-agents/bootstrap/`](https://github.com/yzhao062/anywhere-agents/tree/main/bootstrap). This Python package is a thin CLI wrapper so that agents and users in a Python-first workflow can invoke the same mechanism without reaching for `curl`.

## Options

```bash
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](https://github.com/yzhao062/anywhere-agents#readme) — quickstart and benefits
- [CHANGELOG](https://github.com/yzhao062/anywhere-agents/blob/main/CHANGELOG.md)
- [Issues](https://github.com/yzhao062/anywhere-agents/issues)

## License

Apache 2.0.
