Agents

reloaded-code supports loading agent definitions from markdown files with YAML frontmatter.

The agent file format mirrors OpenCode's schema, similar enough that many files are drop-in compatible, but not identical. See Migrating from OpenCode for details.

Agent file format

An agent file is a markdown file with YAML frontmatter delimited by ---:

---
name: code-searcher
mode: subagent
description: Searches codebases to find relevant files and extracts content
model: synthetic/hf:moonshotai/Kimi-K2.5
permission:
  read: allow
  grep: allow
  glob: allow
  task: deny
tool_settings:
  read:
    line_numbers: false
  grep:
    line_numbers: false
temperature: 0.2
---

You are a code search assistant. Use grep to find relevant files and code patterns,
then read the matching files to extract and summarize the content.

Files must be placed at agent/**/*.md or agents/**/*.md within the scanned directory.

Frontmatter fields

Required:

Field	Description
`description`	What this agent does. Shown when listing available agents.

Optional:

Field	Default	Description
`name`	filename	Agent identifier. If omitted, derived from the file path (e.g. `basic/file-reader.md` becomes `basic/file-reader`).
`mode`	`all`	Agent behaviour: `all`, `primary`, or `subagent`.
`model`	runtime default	LLM to use. Format: `provider/model-id` or `synthetic/hf:huggingface-model-id`.
`permission`	all denied	Map of tool names to `allow`/`deny`.
`tool_settings`	defaults	Per-tool configuration (line numbers, limits, timeouts).
`temperature`	model default	Sampling temperature.
`top_p`	model default	Nucleus sampling parameter.

Mode

Mode	Description
`all`	Both primary and subagent capabilities. Can be used directly or delegated to.
`primary`	Top-level agent. Can delegate work to subagents via the `task` tool.
`subagent`	Can only be invoked by other agents. Not available for direct use.

Permissions

Permissions are default-deny: every tool is blocked unless you explicitly allow it.

permission:
  read: allow
  write: deny
  bash: allow
  task: allow  # Required to delegate to subagents

Pattern-based rules

Several tools support wildcard patterns instead of a simple allow/deny. Evaluation uses last-match-wins: the final matching rule takes effect.

Pattern	Meaning
`**`	Any depth, workspace-relative
`*`	Workspace root only
`/**`	Any file on the system
`?`	Exactly one character

For the full rule table and examples, see Tools > Permission rules.

Model specification

Format: provider/model-id or synthetic/hf:huggingface-model-id.

synthetic is the provider name; hf selects a HuggingFace model by its repository ID (e.g. moonshotai/Kimi-K2.5).

Examples:

openai/gpt-5.4
synthetic/hf:zai-org/GLM-5
ollama-cloud/minimax-m2.7
synthetic/hf:moonshotai/Kimi-K2.5

Model names are validated against the models.dev catalog at runtime; an unrecognized name will produce a load error.

Load the catalog before resolving agents. See Models Catalog for setup instructions and the reloaded-code-models-dev crate API.

Tool settings

Per-tool configuration that overrides defaults. For the full reference with types, ranges, and validation rules, see Tools > Tool Settings.