Date: 2026-09-10

Create custom subagents

Custom subagents are configured agent definitions with scoped prompts and capabilities. They inherit the runtime’s safety and tool-exposure rules.

Use the current implementation

Pass session agent definitions with --agents <json> and select one with --agent <name>. Use nova --help to confirm the JSON shape supported by the installed package.

Boundaries and safety

A custom prompt cannot grant a capability that the runtime does not expose. Review file changes and tool results from every subagent.