Skip to main content
Custom Agent is an AI Agent in Qoder designed to handle specific tasks. You can create custom agents to extend Qoder’s capabilities, with each agent having its own independent context window, tool permissions, and system prompt. Currently, the scheduling method for custom agents is through the subagent approach.

Create a Custom Agent

Qoder provides a built-in create-agent skill that helps you quickly create custom agents through interactive guidance. Usage:
/create-agent <Your requirement, e.g., code review expert>
create-agent will guide you through the following steps:
  • Define the agent’s name and description
  • Select required tool permissions
  • Automatically generate system prompt template
  • Save the agent file to the correct location
If this is your first time creating a custom agent, we recommend using /create-agent to automatically generate the configuration file, ensuring correct formatting and all necessary fields.

Method 2: Manual Creation

You can also manually create a .md file in one of the following locations:
ScopePathAvailability
User-level~/.qoder/agents/<agentName>.mdAll projects
Project-level${project}/.qoder/agents/<agentName>.mdCurrent project only
The file should contain a frontmatter block defining basic information, followed by the system prompt content:
---
name: code-review
description: Code review expert, checks code quality and security
tools: Read, Grep, Glob, Bash
---

You are a senior code reviewer responsible for ensuring code quality.

Review checklist:
1. Code readability
2. Naming conventions
3. Error handling
4. Security checks
5. Test coverage
FieldRequiredDescription
nameYesUnique identifier for the Custom Agent
descriptionYesBrief description of functionality and expertise, used for automatic selection
toolsNoList of allowed tools, comma-separated

Tools List

Tool NameDescription
BashExecute shell commands in your environment
EditMake targeted edits to specific files
WriteCreate or overwrite files
GlobFind files based on pattern matching
GrepSearch for patterns in file content
ReadRead the contents of files
WebFetchFetch content from a specified URL
WebSearchPerform web searches with domain filtering

Using in IDE

There are two ways to invoke custom agents:

Method 1: Automatic Trigger

In the Chat panel, describe the task in natural language, and the model will automatically recognize the intent and select the appropriate custom agent based on description:
Help me review the implementation of this interface
The model will automatically identify and invoke the code-review agent.

Method 2: Manual Trigger

Use /agent-name to manually trigger a specific agent:
/code-review

Detailed Documentation

For a complete guide on Custom Agents, including automatic creation and CLI usage, see CLI Usage Documentation.