assetdex 1.0.1

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.

What's included (v1.0)

• CLI: scan, search, list, info, doctor, export, import, diff, graph, collection, sources, config, mcp, serve — all with --json
• Web dashboard: React SPA served at 127.0.0.1:37242 via assetdex serve
• Asset types: Skills, MCP servers, prompts, agents, rules, templates
• MCP server: assetdex mcp exposes your registry to agents over stdio
• Collections: group assets into named workspaces
• Diff view: see what changed between scans
• Graph: visualize asset relationships

License

Apache-2.0