assetdex 1.0.0

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

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

pipx install assetdex
# or
uv tool install assetdex

Quickstart

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