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
Method 1: Using create-agent (Recommended)
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:
| Scope | Path | Availability |
|---|
| User-level | ~/.qoder/agents/<agentName>.md | All projects |
| Project-level | ${project}/.qoder/agents/<agentName>.md | Current 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
| Field | Required | Description |
|---|
name | Yes | Unique identifier for the Custom Agent |
description | Yes | Brief description of functionality and expertise, used for automatic selection |
tools | No | List of allowed tools, comma-separated |
| Tool Name | Description |
|---|
Bash | Execute shell commands in your environment |
Edit | Make targeted edits to specific files |
Write | Create or overwrite files |
Glob | Find files based on pattern matching |
Grep | Search for patterns in file content |
Read | Read the contents of files |
WebFetch | Fetch content from a specified URL |
WebSearch | Perform 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:
Detailed Documentation
For a complete guide on Custom Agents, including automatic creation and CLI usage, see CLI Usage Documentation.