Awesome-omni-skill kimaki

Control OpenCode agents from Discord via Kimaki CLI

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/cli-automation/kimaki" ~/.claude/skills/diegosouzapw-awesome-omni-skill-kimaki && rm -rf "$T"
manifest: skills/cli-automation/kimaki/SKILL.md
safety · automated scan (low risk)
This is a pattern-based risk scan, not a security review. Our crawler flagged:
  • global npm install
Always read a skill's source content before installing. Patterns alone don't mean the skill is malicious — but they warrant attention.
source content

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

FlagDescription
-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