kimaki

name	kimaki
description	Control OpenCode agents from Discord via Kimaki CLI
license	MIT
compatibility	opencode
metadata	{"audience":"developers","workflow":"automation","platform":"any","homepage":"https://kimaki.xyz","repository":"https://github.com/remorses/kimaki"}

What I do

Kimaki connects Discord to OpenCode. Send a message in Discord → AI agent edits code on your machine.

Installation

# Run directly (recommended)
npx -y kimaki@latest

# Or install globally
npm install -g kimaki

Setup

# Run the interactive setup wizard
npx -y kimaki@latest

This will guide you through:

1. Creating a Discord bot
2. Configuring bot settings (Message Content intent)
3. Generating an invite link
4. Selecting project directories

Architecture

• One bot per machine - Each Discord bot is tied to one computer
• Channels = projects - Each Discord channel maps to a local project directory
• Run on startup - Keep kimaki running to receive messages

Commands

Send prompts

# Send to channel (creates new thread)
npx -y kimaki@latest send --channel CHANNEL_ID --prompt "Your prompt"

# Continue existing thread
npx -y kimaki@latest send --thread THREAD_ID --prompt "Follow-up"

# Continue existing session
npx -y kimaki@latest send --session SESSION_ID --prompt "Prompt"

Session management

# List sessions
npx -y kimaki@latest session list
npx -y kimaki@latest session list --project /path/to/project

# Read session conversation
npx -y kimaki@latest session read SESSION_ID

Files

# Upload file to session
npx -y kimaki@latest upload-to-discord file.md --session SESSION_ID

Projects

# List projects
npx -y kimaki@latest project list

# Add new project
npx -y kimaki@latest project add /path/to/project

Tunnel

# Create tunnel for dev server
npx -y kimaki@latest tunnel --port 3000
npx -y kimaki@latest tunnel --port 3000 --tunnel-id my-app

Update

npx -y kimaki@latest upgrade

Options

Flag	Description
-c, --channel	Discord channel ID
-p, --prompt	Message content
-d, --project	Project directory
-n, --name	Thread name
--thread	Continue existing thread
--session	Continue existing session
--notify-only	Create thread without starting AI
--wait	Wait for response
--worktree	Create git worktree
--model	Specify model (e.g., anthropic/claude-3-5-sonnet-20241022)
--agent	Specify agent type

Tips

• Use --notify-only for scheduled tasks - creates a notification thread you can reply to when ready
• Sessions accumulate history - continue via --thread or --session for context
• Set up multiple bots for multiple machines - add all bots to the same Discord server
• Run data in separate directories for multiple instances: kimaki --data-dir ~/work-bot