Agent reference
Per-tool behavior for the fields on the agents page. Where a tool cannot honor a field, sync prints a note.
effort values by target
Without effort, the agent uses the session's level.
| Target | Values | Output |
|---|---|---|
| Claude Code | low, medium, high, xhigh, max, model dependent | effort, not checked |
| Qoder | Same five names, or a positive integer | effort |
| Junie | Alias of reasoningLevel | effort |
| Factory | low, medium, high | reasoningEffort; other values raise a sync note |
| Codex | Any string | model_reasoning_effort; an integer raises a note |
| Cursor | none | Sync note. Put it in the model id, as above |
| Copilot | none | Sync note. x-copilot.effort still passes through |
| Augment | off, minimal, low, medium, high, xhigh | thinking (Auggie 1.x); other values raise a sync note, and x-augment.thinking wins |
| Every other target | none | Sync note |
Claude model names on other targets
A shared model (a single value or default) set to a Claude model name is left out, with a sync note, on a tool that cannot load it. That tool uses its own default.
- The note suggests
model: {claude: <name>}, or names the tier to fix when the name sits in a tier'sdefault. on-unsupported: errorfails the sync instead.- A value under
model.<target>orx-<target>.modelis written as given. import claudewrites these names asmodel: {claude: <name>}.import codexadds a Codex agent model asmodel.codex.
| Target | Claude names that raise the note |
|---|---|
| Codex, Gemini, OpenCode, Kilo Code | The aliases, inherit, and claude-* ids |
| Cursor, Factory, Kiro | The aliases |
Claude Code's aliases are sonnet, opus, haiku, fable, best, opusplan, sonnet[1m], and opus[1m]. The value default resets Claude's model instead of naming one, so it raises no note.
can and tools support by target
A tool that cannot enforce the list prints a sync note. Check these notes before relying on can: [read] to restrict an agent.
| Target | Behavior |
|---|---|
| Claude Code, Copilot, Junie | Written as a YAML list |
| Qoder, Trae | Written as a comma-separated string (tools: Read, Bash) |
| Windsurf, Kiro, Factory, Gemini, Kilo Code, OpenCode | Changed to the tool's own names or a permission map |
| Antigravity, OpenHands, Goose, Codex, Cursor, Augment | Dropped with a note |
On Trae, an explicitly empty list disables all tools, and an unset field loads every tool. Use x-trae: {tools: ""} to restrict only Trae.
Translation can grant extra access: on Kiro, edit also allows delete_file. Sync prints a note naming the extra access, and on-unsupported: error fails. explain agents/<name>.md lists each tool's names and any widening. Most tools accept their own names through x-<target>.tools, which skips the change.
mcpServers support by target
mcpServers names the servers, usually from mcps/, that one agent may reach. Without it, the agent gets the session's full set. An agent-only server reaches only the agents that name it.
| Target | Behavior |
|---|---|
| Claude Code, Qoder | Server names in the agent file. An agent-only server is written in full instead |
| Kiro | Every named server written in full, under mcpServers |
| OpenHands | Every named server written in full, under mcp_servers. Not when Goose shares .agents/agents/: set outputs.openhands.agents-dir |
| Junie, Factory | Server names in the agent file. An agent-only server's name is left out, except on Junie when it is the only name |
| Antigravity | Dropped; its docs give no shape for an inline server. Set x-antigravity.mcpServers |
| Gemini, Copilot | Dropped. Set x-gemini.mcp_servers or x-copilot.mcp-servers |
| Every other target | Dropped, and agent-only servers left out, with a sync note |
An x-<target> key for the list, such as x-kiro.mcpServers, replaces what sync would write. On Kiro and OpenHands, a name with no MCP spec is dropped with a note.
An empty list keeps every server on Junie and excludes every server on Factory, so list the servers you want.
maxTurns and background by target
A native key under x-<target>, such as x-gemini.max_turns, x-kilo.steps, or x-cursor.is_background, wins. An x-<target> override with the wrong type raises a sync note, and the shared value is used. validate, lint (LINT050), and sync stop on a maxTurns that is not a whole number of 1 or more, or a background that is not true or false.
| Target | maxTurns | background |
|---|---|---|
| Claude Code | maxTurns | background |
| Qoder | maxTurns | background, when background subagent sessions are on |
| Qwen Code | maxTurns | background |
| Junie | maxTurns | Sync note |
| Gemini CLI | max_turns | Sync note |
| Kilo Code, OpenCode | steps | Sync note |
| Cursor | Sync note | is_background |
| Every other target | Sync note | Sync note |
import reads each native key back into maxTurns or background. When the spec already sets the value under x-<target>, import writes it back there and keeps the shared value.
permissionMode and agent hooks support by target
Without either field, the agent uses the session's setting. On Claude Code, a session in bypassPermissions, acceptEdits, or auto mode runs the agent in that mode and ignores its value, and an agent's own bypassPermissions never applies.
| Target | permissionMode | Agent hooks |
|---|---|---|
| Claude Code | Seven values; manual is an alias of default | Written to the agent file |
| Qoder | Six values. Any other value is reported | Seven events. A wider setting is reported |
| OpenHands | Different names (always_confirm, never_confirm, confirm_risky). Set x-openhands | Six snake_case events, command handlers only. Set x-openhands |
| Qwen Code | Not written, with a note: Qwen maps Claude's names to its own approval modes with different strictness. Set x-qwen.approvalMode | Written to the agent file; Stop becomes SubagentStop. Project agent hooks need a trusted folder |
| CodeBuddy | Five values; any other value stops sync | Written to the agent file. Running them needs the user's allowUntrustedFrontmatterHooks choice |
| Grok Build | Written to the agent file | Written to the agent file |
| Junie | Written to the agent file | Copied with the frontmatter, with a note: Junie documents no agent hook field |
| Every other target | Sync note | Sync note |
On Qoder, bypassPermissions becomes acceptEdits when security policy disables it, and an agent runs fewer hook events than the project does.
color support by target
color is written as given and not checked. An unrecognized value affects only the badge.
| Target | Values |
|---|---|
| Augment | Free text, an ANSI color name |
| Kilo Code | Hex or a theme token, so color: blue may not show as expected |
| Claude Code, Qoder | One of eight names: red, blue, green, yellow, purple, orange, pink, cyan |
| OpenHands | Dropped with a note, since it shares .agents/agents/ with Goose, which has no color. Set x-openhands.color to a Rich color name |
readonly by target
| Target | Effect |
|---|---|
| Cursor | Restricted |
| Claude Code | disallowedTools: Write, Edit, NotebookEdit (Bash stays allowed) |
| Codex | sandbox_mode = "read-only", which current Codex ignores (the agent keeps the session sandbox), and a sync note |
| Qwen Code | disallowedTools: [write_file, edit, notebook_edit] (shell stays allowed) |
| Factory | tools: read-only with mcpServers: [] unless servers are listed. Wins over a portable tools list |
| Other targets | Sync note |
An explicit x-claude.disallowedTools, x-qwen.disallowedTools, x-codex.sandbox_mode, or x-factory.tools wins.