Skip to content

yachiyo agent

Controls how delegateTask runs work: in-process worker subagents (the default) or external ACP agents (deprecated).

Terminal window
yachiyo agent mode worker
yachiyo agent mode acp

Sets the subagent runtime mode. Worker mode exposes Explore, Plan, Review, and General through delegateTask. ACP mode routes to external agent processes and is deprecated.

Terminal window
yachiyo agent list

Shows the current mode along with any ACP profiles still configured.

Terminal window
yachiyo agent show <id-or-name>
yachiyo agent add --payload '<json>'
yachiyo agent update <id-or-name> [--payload '<json>']
yachiyo agent remove <id-or-name>
yachiyo agent enable <id-or-name>
yachiyo agent disable <id-or-name>

add requires at least name and command. An id is generated if you omit one, and the rest default to safe values (enabled: true, args: [], env: {}).

Terminal window
yachiyo agent add --payload '{
"name": "My Agent",
"command": "npx",
"args": ["-y", "some-acp-agent"],
"env": {"MODE": "prod"}
}'

update merges — only supplied fields change, and id is always preserved.

Terminal window
yachiyo agent update my-agent --payload '{"description":"Updated","args":["-y","some-acp-agent@latest"]}'

disable keeps the profile in config but stops offering it; remove deletes it permanently.

FieldTypeDescription
idstringStable identifier, auto-generated on add
namestringDisplay name
enabledbooleanWhether the profile is active
descriptionstringShort description shown in the UI
commandstringExecutable to launch (npx, node, an absolute path)
argsstring[]Arguments passed to the command
envRecord<string,string>Extra environment variables