Metadata-Version: 2.5
Name: agt-env
Version: 0.0.3
Summary: List the skills, MCP servers, and extensions available to each coding agent
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: rich>=14.3
Description-Content-Type: text/markdown

# agt-env

A read-only CLI that shows what each coding agent on your machine can use from the current directory.

**Status:** early development. It currently lists **skills**, **MCP servers**, **plugins**, **hooks**, **subagents**, and **commands** for **Claude Code**, **Codex**, **OpenCode**, **Pi**, and **Antigravity CLI**. More agents are planned; see the [product requirements](docs/PRD.md). [Agent discovery rules](docs/agents/README.md) describes how each agent finds these.

## Usage

Run it from your project root to include project-level configuration. No install is needed with [uv](https://docs.astral.sh/uv/):

```sh
uvx agt-env                            # list everything for active agents
uvx agt-env --all                      # also show agents not both installed and configured
uvx agt-env -a codex -k mcp            # filter by agent and kind
uvx agt-env -n my-skill --detail       # filter by name, and add paths and other details
uvx agt-env "browser test" lint        # search all fields: (browser and test) or lint
```

`agt-env` only reads files. It never changes your configuration or runs your agents.

Output is plain text when piped, or with `--no-color` or `NO_COLOR`.

Problems are shown with the items they affect: why an item is `broken`, and when a same-named item is used instead (`shadowed`). Search for them like anything else, as in `uvx agt-env shadowed`.

## Development

```sh
uv run agt-env   # run from source
uv run pytest     # run the tests

# Also compare results with real agents, in a temporary HOME
AGT_ENV_CLAUDE=/path/to/claude AGT_ENV_CODEX=/path/to/codex \
AGT_ENV_OPENCODE=/path/to/opencode AGT_ENV_PI=/path/to/pi AGT_ENV_AGY=/path/to/agy \
uv run pytest
```
