# tools-registry — design fragments

<!-- GENERATED by scripts/build-map.py — do not edit by hand; edit fragment frontmatter instead -->

Small, focused fragments that mirror the codebase. Each declares the source files it
covers (frontmatter `sources:`). Regenerate this index with
`python3 .claude/skills/tools-registry-context/scripts/build-map.py`.

## Foundation

| Fragment | Status | Covers |
|---|---|---|
| [Tools Registry — charter (what it is, why, the proxy model)](foundation/charter.md) | foundational | 2026-06-30-jason-tools-registry.md, README.md |

## Architecture (proxy, auth, data model)

| Fragment | Status | Covers |
|---|---|---|
| [Auth & secrets — injectors, encryption, OAuth freshness, health](architecture/auth-secrets.md) | shipped | injectors.py, crypto.py, oauth.py, oauth_providers.py, … |
| [Endpoint catalog — what you can DO with a connected key, and which provider should do it](architecture/catalog.md) | shipped | catalog_store.py, endpoint_stats.py |
| [Data model — the registry tables, async DB, audit writer](architecture/data-model.md) | shipped | models.py, db.py, audit.py, analytics.py, … |
| [Local proxy — catch a program's own outgoing calls (`treg <command>`)](architecture/local-proxy.md) | shipped | localproxy.py, server.js |
| [Local CLI runs — run a vendor CLI as a dedicated user with a server-held credential (`treg run`)](architecture/local-run.md) | shipped | localrun.py, egress.py, fsjail.py |
| [MCP — the front door for assistants, and treg as an OAuth authorization server](architecture/mcp-oauth.md) | shipped | mcp.py, mcp_oauth.py, connect-demo.html |
| [Money — prepaid balance, the ledger, Stripe, and the reports that check it](architecture/money.md) | shipped | ledger.py, models.py, billing.py, reconcile.py, … |
| [Multi-tenancy — orgs, memberships, invites, per-org scoping](architecture/multi-tenancy.md) | shipped | models.py, api.py, db.py |
| [The proxy — faithful credential-injecting relay + tool resolution](architecture/proxy-model.md) | shipped | proxy.py, api.py |
| [Super-admin — cross-tenant read + control](architecture/super-admin.md) | shipped | api.py, config.py |

## Interfaces (API · CLI · skill)

| Fragment | Status | Covers |
|---|---|---|
| [The API — the only brain (FastAPI)](interface/api.md) | shipped | api.py, catalog_store.py, email.py, runner.py, … |
| [catalog-review-proposal](interface/catalog-review-proposal.md) | ? | — |
| [The CLI (treg) + skill scaffolding](interface/cli.md) | shipped | cli.py, convert.py, agents.py |
| [The web dashboard (Ledger, served from FastAPI)](interface/dashboard.md) | shipped | index.html, tutorial.js, tutorial.html, tour.js, … |
| [Import — scan a .env AND/OR a skills dir, auto-register as tools + bundles](interface/env-import.md) | in-progress | providers.py, skills.py |
| [Landing sandbox studio — anonymous try-it, hosted skills, CLI installer](interface/landing-sandbox.md) | shipped | sandbox.py, pubfeed.py, api.py, index.html, … |
| [Onboarding — the first-run demo team (dashboard + CLI)](interface/onboarding.md) | shipped | demo.py, cli.py, index.html |
| [Search surfaces — robots, sitemap, the crawlable catalog, and the social card](interface/seo.md) | shipped | api.py, robots.txt, catalog.css, index.html, … |
| [Shell mode (treg shell) — transparent CLI interception](interface/shell.md) | shipped | shell.py, cli.py |
| [The shippable tools-registry skill (3 personas)](interface/skill.md) | shipped | skill.md, mcp_install.py, build_plugin.py, plugin.json, … |

## Ops (deploy, scale)

| Fragment | Status | Covers |
|---|---|---|
| [Running & deploying the server](ops/deploy.md) | shipped | __main__.py, selfhost.sh, config.py, db.py, … |

## Reference

| Fragment | Status | Covers |
|---|---|---|
| [Glossary](reference/glossary.md) | reference | 2026-06-30-jason-tools-registry.md |

## guides

| Fragment | Status | Covers |
|---|---|---|
| [Expanding a marketplace category — the add-a-provider playbook](guides/expanding-a-category.md) | guide | oauth_providers.py, api.py, config.py |