← All docs

DOCS

  1. Getting Started
  2. Configuration
  3. Tools
  4. Sessions
  5. Compaction & Branch Summarization
  6. Subagents
  7. Extensions
  8. Themes
  9. Memory System
  10. Skills
  11. Code intelligence (LSP)
  12. Termux Support
  13. Environment variables
  14. Custom Providers
  15. JSON Event Stream Mode
  16. Keybindings
  17. Prompt Templates
  18. RPC Mode
  19. Session File Format
  20. Shell Aliases
  21. Terminal Setup
  22. tmux Setup
DOCS
  1. Getting Started
  2. Configuration
  3. Tools
  4. Sessions
  5. Compaction & Branch Summarization
  6. Subagents
  7. Extensions
  8. Themes
  9. Memory System
  10. Skills
  11. Code intelligence (LSP)
  12. Termux Support
  13. Environment variables
  14. Custom Providers
  15. JSON Event Stream Mode
  16. Keybindings
  17. Prompt Templates
  18. RPC Mode
  19. Session File Format
  20. Shell Aliases
  21. Terminal Setup
  22. tmux Setup
ON THIS PAGE
  1. Built-in Types
  2. Custom Subagents
  3. Frontmatter Options
  4. Usage

Subagents

Subagents are parallel workers that handle tasks independently with their own context window, keeping the main conversation focused.

#Built-in Types

TypePurposeTools
general-purposeDefault delegationread, grep, find, ls, lsp
exploreCodebase explorationread, grep, find, ls, lsp
planPlanning and analysisread, grep, find, ls, lsp
verificationVerify changes workread, grep, find, ls, lsp
reviewerCode reviewread, grep, find, ls, lsp

#Custom Subagents

Define custom subagents in .neo-code/agents/ (project) or ~/.neo-code/agent/agents/ (global) as markdown files with frontmatter:

---
name: my-agent
description: Specialized agent for database migrations
tools:
  - read
  - grep
  - find
  - ls
model: deepseek-v4-0324
maxTurns: 10
mcpServers:
  - my-db-server
---

You are a database migration specialist. Focus on...

#Frontmatter Options

KeyTypeDescription
namestringAgent identifier
descriptionstringWhen to use this agent
toolsstring[]Allowed tools
disallowedToolsstring[]Explicitly blocked tools
modelstringModel override
maxTurnsnumberMaximum conversation turns
mcpServersstring[]MCP servers this agent can access

#Usage

The LLM dispatches subagents via the agent tool when tasks benefit from parallel execution or isolated context. Use /agents to list available subagent definitions.

ON THIS PAGE

  1. Built-in Types
  2. Custom Subagents
  3. Frontmatter Options
  4. Usage
Previous← Compaction & Branch SummarizationNextExtensions →

Neo Code

Neosantara-first AI coding agent for your terminal.

Product

  • Docs
  • Pricing
  • GitHub

Neosantara

  • Dashboard
  • API

Legal

  • Terms
  • Privacy

2026 Neosantara. All rights reserved.