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