Terms of Service — Kimaki

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

/

GitHub↗Changelog↗

Getting Started

Quick Start
What is Kimaki?
Battle tested every day
All your models, including subscriptions
Core Features
How messages reach a session
Setup
Commands
Access Control
Best Practices
Troubleshooting
Advanced Topics

Models & Subscriptions

The /login command
Using subscriptions instead of API credits
Multiple accounts and rotation
Choosing the model after login
API keys instead of subscriptions

Model & Agent Switching

Why agents are faster than /model
Creating agent files
Examples
Frontmatter reference
Effort customization notes
Override the default build agent variant
Activating
Setting variant via /model

Background Sync

Use cases
How it works
Disabling sync

Core Concepts

Channels & Threads

Why this matters
How a channel becomes a project
How a message becomes a session
Resuming, forking, and searching
One server per machine, many channels

Message Handling

The default: queue after the current step
The interrupt: abort after ~3 seconds
Tuning the timeout
When you want to wait instead of interrupt

Managing Sessions

Resuming and starting
Forking
Sharing and identifying
Context management
Undo and redo

Features

Why queue instead of just sending
Queueing a message
Editing a queued message
When a queued message is sent
Queueing a command
Clearing the queue

btw (side questions)

The problem it solves
Using btw
What happens
btw vs fork vs queue

The typical flow
Creating a worktree
Why isolate work in a worktree
Merging back
Conflict resolution by the agent

Using it
Common cases
Why this beats raw diff output

Scheduled Tasks

Scheduling with --send-at
Flagship example: a morning email digest
Notify-only reminders
Other recurring patterns
Managing tasks

How it works
Accuracy from your project file tree
Models and setup
Sending audio back

Sending images to the agent
Seeing images from the agent
Common workflows

OpenCode Commands

How names map
Passing arguments
Triggering commands programmatically
Refreshing the command list

Using the ! prefix
Where it runs
The slash command equivalent
What it's good for

Remote Access

Browser VS Code

Using it
Auto-stop after 30 minutes
When to use it vs alternatives

Basic usage
Passing the public URL to your app
Options
Running it in the background

macOS Setup
Linux Setup

Configuration

Who can trigger Kimaki
Blocking users
Letting other bots trigger Kimaki
Mention mode for busy channels

Tool Permissions

Approval buttons
Granting extra directories with /add-dir
Default permissions in opencode.json
Locking down a single session

The three levels
Setting verbosity
What "essential tools" means

How MEMORY.md works
What to keep in it
Context awareness reminders
Tips

Using it
Project-scoped, no extra storage
MCP prompts as slash commands

Managing Projects

Adding an existing project
Creating a brand new project
Removing a project
Listing projects

Guides

Troubleshooting

/restart-opencode-server
/upgrade-and-restart
Common symptoms and fixes
Debugging with logs
Restarting the bot process

CI & Automation

Programmatically Start Sessions
Environment Variables
CLI Options
Example: GitHub Actions on New Issues
How It Works
Add Project Channels
Scheduled Tasks
Per-Session Permissions

Architecture: One Bot Per Machine
Running Multiple Instances
Multiple Discord Servers
Method 1: Use /add-project command
Method 2: Re-run CLI with --add-channels

Programmatic Gateway

Use case
Event lifecycle
SSE wire format
Parsing events with eventsource-parser
CLI flags
Custom callback URL
Running multiple instances
Why SSE format instead of plain JSON lines

Plugins

Abort Session with "x"

Why you need this
How it works
Installation
Using other OpenCode plugins

Reference

Commands Reference

Session slash commands
Model & agent slash commands
Queue slash commands
Project & worktree slash commands
Access & permissions slash commands
Remote access slash commands
Maintenance slash commands
Message shortcuts
CLI subcommands

Legal

Terms of Service

Ask AI about this page

Powered byHolocron