agent-registry

You can reduce token overhead by implementing lazy loading for Claude Code agents. The Agent Registry builds a lightweight metadata index and retrieves specific agents on-demand, preventing the system from pre-loading the entire agent set.

To migrate agents to on-demand loading, run the python scripts/init_registry.py initialization script. This process features an interactive migration UI with category grouping and token indicators, while non-migrated agents continue loading normally for backward compatibility.

Yes, you can search for specific agents by intent using a smart search function. The registry applies BM25 and keyword matching algorithms to the agent metadata index, allowing Claude to find and load only the most relevant specialized agents.

Yes, the interactive migration UI requires the questionary Python dependency to be installed. This library powers the category grouping and selection interface used during the agent migration workflow.

Agents that are not migrated to the lazy-loading registry continue to load normally. The registry maintains backward compatibility, ensuring non-migrated agents function alongside the on-demand loaded agents without interruption.

Loading all specialized agents at once consumes unnecessary tokens because the system processes entire agent definitions upfront. Using a lightweight metadata index for lazy loading eliminates this overhead by retrieving agent content only when explicitly requested.