> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: Commands Reference
description: Every Kimaki slash command and CLI subcommand in one place.
icon: lucide:slash
---

A complete reference of Kimaki's **Discord slash commands** and **CLI subcommands**, ordered by how often you'll reach for them. For deep dives, follow the links.

## Session slash commands

| Command                 | Description                                                                     |
| ----------------------- | ------------------------------------------------------------------------------- |
| `/resume <session>`     | Resume a previous session ([docs](/docs/core-concepts/sessions))                |
| `/abort`                | Stop the current running session                                                |
| `/new-session <prompt>` | Start a new session with a prompt, files, and agent                             |
| `/btw <prompt>`         | Fork context into a new thread for a side question ([docs](/docs/features/btw)) |
| `/fork`                 | Fork the session from a previous message ([docs](/docs/core-concepts/sessions)) |
| `/fork-subagent`        | Fork a subagent task into its own thread                                        |
| `/last-sessions`        | List the 20 most recently active sessions                                       |
| `/share`                | Generate a public URL for the session                                           |
| `/session-id`           | Show the session ID and an attach command                                       |
| `/compact`              | Summarize and compact the session context                                       |
| `/context-usage`        | Show token usage and context window percentage                                  |
| `/undo`                 | Undo the last assistant message (revert file changes)                           |
| `/redo`                 | Redo the last undone message                                                    |

## Model & agent slash commands

| Command                 | Description                                                                                  |
| ----------------------- | -------------------------------------------------------------------------------------------- |
| `/model`                | Change the model for this channel or session ([docs](/docs/getting-started/model-switching)) |
| `/agent`                | Change the agent for this channel or session                                                 |
| `/<name>-agent`         | Instantly switch to a named agent file                                                       |
| `/login`                | Authenticate a provider via OAuth or API key ([docs](/docs/getting-started/subscriptions))   |
| `/model-variant`        | Change the thinking-level variant for the current model                                      |
| `/unset-model-override` | Remove model overrides and use the default                                                   |
| `/verbosity`            | Set how much tool output is shown ([docs](/docs/configuration/verbosity))                    |

## Queue slash commands

| Command                    | Description                                                              |
| -------------------------- | ------------------------------------------------------------------------ |
| `/queue <message>`         | Queue a message for after the current run ([docs](/docs/features/queue)) |
| `/queue-command <command>` | Queue a registered command                                               |
| `/clear-queue [position]`  | Clear all queued messages, or one by position                            |

## Project & worktree slash commands

| Command                      | Description                                                                       |
| ---------------------------- | --------------------------------------------------------------------------------- |
| `/add-project <project>`     | Create channels for an existing project ([docs](/docs/configuration/projects))    |
| `/create-new-project <name>` | Create a new project folder and start a session                                   |
| `/remove-project <project>`  | Remove channels for a project                                                     |
| `/new-worktree <name>`       | Move the session into an isolated git worktree ([docs](/docs/features/worktrees)) |
| `/merge-worktree`            | Merge the worktree branch into the default branch                                 |
| `/worktrees`                 | List all worktrees for the channel's project                                      |
| `/toggle-worktrees`          | Toggle automatic worktree creation for new sessions                               |

## Access & permissions slash commands

| Command                | Description                                                                              |
| ---------------------- | ---------------------------------------------------------------------------------------- |
| `/add-dir <directory>` | Grant the session access to an extra directory ([docs](/docs/configuration/permissions)) |
| `/toggle-mention-mode` | Only respond to @mentions in this channel ([docs](/docs/configuration/access-control))   |
| `/mcp`                 | List and toggle MCP servers for the project ([docs](/docs/configuration/mcp))            |
| `/transcription-key`   | Set the API key used for voice transcription ([docs](/docs/features/voice))              |

## Remote access slash commands

| Command                        | Description                                                                    |
| ------------------------------ | ------------------------------------------------------------------------------ |
| `/vscode`                      | Open the project in browser VS Code ([docs](/docs/remote-access/vscode))       |
| `/screenshare`                 | Share your screen via VNC tunnel ([docs](/docs/remote-access/screen-sharing))  |
| `/screenshare-stop`            | Stop screen sharing                                                            |
| `/diff`                        | Generate a shareable diff URL ([docs](/docs/features/diff-viewer))             |
| `/run-shell-command <command>` | Run a shell command in the project dir ([docs](/docs/features/shell-commands)) |

## Maintenance slash commands

| Command                    | Description                                                                                 |
| -------------------------- | ------------------------------------------------------------------------------------------- |
| `/tasks`                   | List scheduled tasks with cancel buttons ([docs](/docs/features/scheduled-tasks))           |
| `/restart-opencode-server` | Restart the OpenCode server and re-register commands ([docs](/docs/guides/troubleshooting)) |
| `/upgrade-and-restart`     | Upgrade Kimaki to the latest version and restart                                            |

Your OpenCode commands, skills, and MCP prompts are also registered automatically as `/<name>-cmd`, `/<name>-skill`, and `/<name>-mcp-prompt`. See [OpenCode Commands](/docs/features/opencode-commands).

## Message shortcuts

| Shortcut               | Effect                                                                         |
| ---------------------- | ------------------------------------------------------------------------------ |
| `!<command>`           | Run a shell command in the project dir ([docs](/docs/features/shell-commands)) |
| `... . queue`          | Queue the message for after the current run ([docs](/docs/features/queue))     |
| `... . btw`            | Fork context to answer a side question ([docs](/docs/features/btw))            |
| voice note             | Transcribed and sent as a prompt ([docs](/docs/features/voice))                |
| image / PDF attachment | Sent to the agent as inline content ([docs](/docs/features/images))            |

## CLI subcommands

```bash
# Start the bot (interactive setup on first run)
npx -y kimaki@latest

# Projects
kimaki project add [directory]
kimaki project list
kimaki project create <name>
kimaki project remove <channel-id>

# Start or continue sessions programmatically
kimaki send --channel <channel-id> --prompt 'your prompt'
kimaki send --thread <thread-id> --prompt 'follow-up'
kimaki send --channel <channel-id> --prompt '...' --send-at '0 9 * * 1'

# Scheduled tasks
kimaki task list
kimaki task edit <id> --prompt 'new prompt'
kimaki task delete <id>

# Sessions
kimaki session list
kimaki session search 'query'
kimaki session read <session-id>

# OAuth account pools
kimaki multioauth list
kimaki multioauth anthropic list
kimaki multioauth openai check

# Bot presence
kimaki bot status set <text>
kimaki bot status clear
kimaki discord-install-url

# Tooling
kimaki tunnel -- pnpm dev
kimaki upload-to-discord --session <id> <file...>
kimaki tts 'text' -o out.mp3
kimaki sqlitedb
kimaki upgrade
```

See [CI & Automation](/docs/guides/ci-automation) for the full `kimaki send` flag reference and scheduling options.