Metadata-Version: 2.4
Name: assetdex
Version: 1.0.0
Summary: The inventory, discovery, and navigation layer for your personal AI assets.
Project-URL: Homepage, https://github.com/zainale/assetdex
Project-URL: Repository, https://github.com/zainale/assetdex
Project-URL: Issues, https://github.com/zainale/assetdex/issues
Author-email: Zain <zainalework@gmail.com>
License: Apache-2.0
Keywords: ai,assets,claude,discovery,inventory,mcp,skills
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Requires-Dist: fastapi>=0.111
Requires-Dist: pydantic>=2.7
Requires-Dist: pyyaml>=6
Requires-Dist: rank-bm25>=0.2.2
Requires-Dist: rich>=13
Requires-Dist: typer>=0.12
Requires-Dist: uvicorn[standard]>=0.29
Provides-Extra: dev
Requires-Dist: httpx>=0.27; extra == 'dev'
Requires-Dist: hypothesis>=6; extra == 'dev'
Requires-Dist: jsonschema>=4.21; extra == 'dev'
Requires-Dist: pyright>=1.1; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov>=5; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Provides-Extra: mcp
Requires-Dist: mcp>=1.2; extra == 'mcp'
Description-Content-Type: text/markdown

# AssetDex

**The inventory, discovery, and navigation layer for your personal AI assets.**

> What do I have? What should I reach for right now? How does it all fit together?

AssetDex scans your machine for AI assets — Claude Skills, MCP servers, prompts, agents, rules, and templates — and gives you a unified, searchable registry. The day-one demo: `assetdex search "redesign my SaaS landing page"` returns the right four assets in under a second, without you remembering they exist.

## Install

```bash
pipx install assetdex
# or
uv tool install assetdex
```

## Quickstart

```bash
assetdex scan          # Scan and build your registry
assetdex search "landing page redesign"
assetdex list          # Browse all assets
assetdex info frontend-design
assetdex doctor        # Health check
assetdex export --format md --out my-assets.md
```

## How it works

1. **Source adapters** walk configured roots (`~/.claude/skills`, `~/.agents/skills`) and enumerate asset directories.
2. **Extractors** read metadata from SKILL.md frontmatter, README files, and JSON/YAML sidecars.
3. **Normalizer** merges metadata and computes content hashes.
4. **BM25 search engine** + a curated **synonym map** enables natural-language task queries without any AI.

The registry is plain JSON at `~/.assetdex/registry.json`. You own it.

## Principles

- **Local-first.** Everything works fully offline. No network calls in the core.
- **Privacy-first.** No telemetry. No accounts. No cloud.
- **Zero AI in the implementation.** The synonym map is the intelligence.
- **Human-readable data.** The registry is JSON you can open and understand.

## Commands

| Command | Purpose |
|---|---|
| `assetdex scan` | Scan all sources and build the registry |
| `assetdex search <query>` | Ranked discovery with BM25 + synonyms |
| `assetdex list` | List assets with filters |
| `assetdex info <name>` | Detailed view of one asset |
| `assetdex doctor` | Health diagnostics |
| `assetdex export` | Export registry (json/ndjson/md/csv) |
| `assetdex sources` | List configured adapters and roots |
| `assetdex config` | View configuration |
| `assetdex version` | Print version |

Every command supports `--json` for scriptable output.

## Roadmap

- **v0.1 (now):** CLI-only. Claude Skills + Skills-CLI. BM25 search. Schema v1.
- **v0.2:** MCP servers. Cursor, Windsurf, Cline adapters.
- **v1.0:** Local web dashboard (React + FastAPI).
- **v1.x:** Prompts, agents, rules, templates. Collections. Asset relationships.
- **v2.0:** Provenance signals. Remote update detection.

## License

Apache-2.0
