Sub-issue of #10. Tracking the UI consumer for `catalog/sub-agents.json`.
State today
- Sync: `scripts/sync-sub-agents.js` runs on the weekly cron, writes `catalog/sub-agents.json` (16 frontmatter fields a `~/.claude/agents/.md` definition file accepts: `name`, `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `maxTurns`, `skills`, `mcpServers`, `hooks`, `memory`, `background`, `effort`, `isolation`, `color`, `initialPrompt`).
- Backend: round-trips through `read_catalog` as `sub_agents` on the wire.
- Frontend: nothing reads it. Declared as `sub_agents: unknown` in `src/lib/catalog.ts`.
Blocker on the natural consumer
The natural consumer is a drawer cross-reference for sub-agent definition files — but knobs.cc doesn't enumerate sub-agent files today (we only read `settings.json` layers). A UI consumer requires a new read path first: walk `~/.claude/agents/.md` (and `/.claude/agents/.md`), parse the YAML frontmatter, surface in a sub-agents panel and/or as a drawer cross-reference on related settings keys.
Decision needed: add the prerequisite read path, or de-scope the catalog from cron sync until a consumer exists.
Related
Sub-issue of #10. Tracking the UI consumer for `catalog/sub-agents.json`.
State today
Blocker on the natural consumer
The natural consumer is a drawer cross-reference for sub-agent definition files — but knobs.cc doesn't enumerate sub-agent files today (we only read `settings.json` layers). A UI consumer requires a new read path first: walk `~/.claude/agents/.md` (and `/.claude/agents/.md`), parse the YAML frontmatter, surface in a sub-agents panel and/or as a drawer cross-reference on related settings keys.
Decision needed: add the prerequisite read path, or de-scope the catalog from cron sync until a consumer exists.
Related