How do I install the Kimaki skill?

Run npx skillmds@latest add diegosouzapw/kimaki in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Kimaki skill do?

Control OpenCode agents from Discord via Kimaki CLI It is listed under Coding & Dev Tools on SkillMD.

Is Kimaki safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Kimaki?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Kimaki free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Kimaki?

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Kimaki by diegosouzapw — Agent Skill

Name: Kimaki
Rating: 4.5 (4 reviews)
Author: diegosouzapw

File contents

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:

Creating a Discord bot
Configuring bot settings (Message Content intent)
Generating an invite link
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

---name: kimakidescription: Control OpenCode agents from Discord via Kimaki CLIlicense: MIT---## What I do[Kimaki](https://kimaki.xyz) connects Discord to [OpenCode](https://github.com/opencode-ai/opencode). Send a message in Discord → AI agent edits code on your machine.## Installation```bash# Run directly (recommended)npx -y kimaki@latest# Or install globallynpm install -g kimaki```## Setup```bash# Run the interactive setup wizardnpx -y kimaki@latest```This will guide you through:1. Creating a Discord bot2. Configuring bot settings (Message Content intent)3. Generating an invite link4. 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```bash# Send to channel (creates new thread)npx -y kimaki@latest send --channel CHANNEL_ID --prompt "Your prompt"# Continue existing threadnpx -y kimaki@latest send --thread THREAD_ID --prompt "Follow-up"# Continue existing sessionnpx -y kimaki@latest send --session SESSION_ID --prompt "Prompt"```### Session management```bash# List sessionsnpx -y kimaki@latest session listnpx -y kimaki@latest session list --project /path/to/project# Read session conversationnpx -y kimaki@latest session read SESSION_ID```### Files```bash# Upload file to sessionnpx -y kimaki@latest upload-to-discord file.md --session SESSION_ID```### Projects```bash# List projectsnpx -y kimaki@latest project list# Add new projectnpx -y kimaki@latest project add /path/to/project```### Tunnel```bash# Create tunnel for dev servernpx -y kimaki@latest tunnel --port 3000npx -y kimaki@latest tunnel --port 3000 --tunnel-id my-app```### Update```bashnpx -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`

Frequently asked questions

Kimaki