Get an agent recipe
Returns one named agent recipe.
Path Parameters
The agent recipe's name.
128^[^\s/\\]+$Query Parameters
Absolute path of the repository to resolve recipes for. A repository's own .claude/agents and .narya/agents are read only when it is named here AND its instruction files have been trusted; with no repository named, the answer carries the built-ins, the user's own recipes and the installed packages' only.
4096Response
The agent recipe.
A named agent recipe — instructions, allowed tools, model and permission policy. Recipes come from configuration and packages; read-only through this API in v1.
128^[^\s/\\]+$1024The model the recipe runs on; the session default when absent.
Tool names the recipe may use.
Name of the permission policy the recipe runs under.
Where the recipe may be used: primary is the session's own agent, subagent is a delegate, all is both. A client offering a primary-agent picker lists primary and all.
primary, subagent, all Where the recipe was read from, nearest source winning a name collision: a built-in, the user's own narya or Claude Code directory, an installed package, or the repository's own .claude/.narya directory.
builtin, user, claude-user, package, project-claude, project-narya The package that supplied the recipe; absent for built-ins and local configuration.

