OpenCode Commands

Kimaki registers your projects' OpenCode agents, commands, and skills as Discord slash commands. What you can start in OpenCode, you can start from Discord.

1/review-cmd arguments: the auth module

Ask AI about this page

How names map

Kimaki adds a suffix to each name, so the kinds stay apart and do not collide with Kimaki's own commands:

  primary agent "plan"      ──▶ /plan-agent
  OpenCode command "review" ──▶ /review-cmd
  skill "analysis"          ──▶ /analysis-skill

Source	Suffix	Example	Options
Primary agent	`-agent`	`/plan-agent`	`prompt`, `variant`
Command	`-cmd`	`/review-cmd`	`arguments`
Skill	`-skill`	`/analysis-skill`	`arguments`

Names are lowercased and cut to fit Discord's 32-character limit. The suffix always stays. Subagents, hidden agents, and the built-in init command get no slash command.

Kimaki reads the agents, commands, and skills of every project channel in the server. If two projects have the same name, the first one wins.

Running them

/<name>-cmd arguments:... runs the OpenCode command with the arguments.
/<name>-skill arguments:... sends the arguments as a prompt with that skill attached.
/<name>-agent without a prompt switches the agent. With prompt:... it sends the prompt with that agent. variant: picks a thinking level for the current model.

In a project channel, the command starts a new thread. In a thread, it continues that session. Like a normal message, it interrupts the current run.

MCP prompts

OpenCode names MCP prompts server:prompt. Names with a colon get no slash command. Type them as a message instead:

1/github:review-pr 123

Typing a command as a message

A message that starts with /name runs the OpenCode command when the project has it. Otherwise the text goes to the agent as a normal prompt.

1/review fix the auth module

Add the queue suffix to run the command after the current run: /review the auth module. queue. Or use /queue-command, which autocompletes the project's commands.

Triggering commands from the CLI

kimaki send accepts the same /name args prompt:

1kimaki send --thread <thread-id> --prompt '/review fix the auth module'

kimaki session command runs a command, skill, or MCP prompt in a session. Add --queue to run it after the current turn:

1kimaki session command review the auth module --session <session-id> --queue

See CI & Automation for more on kimaki send.

Refreshing the command list

Kimaki updates the slash commands automatically when OpenCode reports a change to agents, commands, or skills. You do not need to restart. Discord can take a moment to show the new list.

Discord allows 100 commands per server. When there are more, Kimaki leaves out skills first.

Skills you add to a project show up as /<name>-skill, so you can start a whole skill workflow from one Discord command.