Create custom agents

Custom commands add your own workflows to Cate’s menu: license audits, dependency updates, release notes, migration scripts, compliance checks — anything you want an agent to repeat reliably.

They run within the full context of Cate and have access to the same MCP tools as built-in agents — creating issues, opening pull requests, transitioning statuses, posting comments, and anything else a built-in command can do.

Create a custom workflow

Click New Task in the top right, then Configure → Create Custom Workflow to start an interview that produces a new workflow markdown file in your .cate/ directory. The agent asks focused questions about scope: what the workflow produces, whether it needs the issue tracker, whether it should run interactively or autonomously.

The agent writes the prompt

You get a working prompt without writing one from scratch. The agent explores your codebase for relevant patterns, then drafts the instructions that tell an executing agent what to do. You review and iterate until it’s right.

For workflows that modify files, the prompt includes a complete git lifecycle: branch, commit, push, PR — handled automatically.

Name, categorize, register

Note

Custom agents appear in the menu after the changes are merged and you re-open the repository. It’ll soon be seamless. :)

Your command shows up under Configure → Extend, ready for the whole team to launch. You pick a name and category. The agent writes the prompt to .cate/commands/custom/<name>.md and a registration entry to .cate/custom-workflows.json. Both are version-controlled. It offers to commit and open a PR.