Metadata-Version: 2.4
Name: capdisc
Version: 0.1.1
Summary: Discovers Claude Code capabilities — skills, agents, plugins, MCP servers, hooks — into typed catalogs and an environment report.
Project-URL: Homepage, https://github.com/Magic-Man-us/capability-discovery
Project-URL: Repository, https://github.com/Magic-Man-us/capability-discovery
Author: Magic-Man-us
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: fastmcp>=3.4.4
Requires-Dist: py-key-value-aio[filetree]>=0.4.5
Requires-Dist: pydantic-settings>=2.14.2
Requires-Dist: pydantic>=2.13.4
Requires-Dist: pyyaml>=6.0.3
Description-Content-Type: text/markdown

# capdisc

Discovers Claude Code capabilities — skills, agents, plugins, MCP servers, hooks — into typed
Pydantic catalogs and an environment report.

## Install

```bash
uv sync
```

## Library

```python
from pathlib import Path
from capdisc.discovery import scan_environment
from capdisc.scope import ScopeRoots

roots = ScopeRoots.discover(start=Path.cwd(), home_dir=Path.home())
catalog = scan_environment(roots)
for entry in catalog.entries:
    ...  # CatalogSkill | CatalogTool | CatalogMcpServer | CatalogPlugin
```

`report.EnvironmentReport` captures the discovery harvest (scan roots, on-disk inventory, skills,
builtin tools, plugins with per-component token cost, MCP servers). `mcp_harvest` and `mcp_catalog`
enumerate connected MCP servers; `plugin_catalog` reads installed plugins; `scope` resolves which
roots to scan.

The package ships `py.typed`.

## Tests

```bash
uv run pytest
uv run mypy src
uv run ruff check .
```
