Kimaki Tools

Use this skill to execute repeatable Kimaki CLI operations from an OpenCode session.

Trigger Conditions

Activate when the user asks to do Kimaki operations such as:

• Add/link the current OpenCode session to Discord/Kimaki

• List Kimaki projects or sessions

• Read archived session logs

• Start a Kimaki session from CLI (kimaki send )

• Start a worktree session from CLI

Core Capability: Link Current Session

When the user says to add/link the current OpenCode session to Kimaki/Discord:

• Resolve the current session ID.

• Prefer explicit user-provided session ID.

• Else use the session ID from system context.

• Run:

bash scripts/link-session-to-discord.sh --session-id <sessionId> --project "$(pwd)" --user "lp"

• Report:

• Created/used Discord thread ID + URL

• Confirmation that mapping was inserted in thread_sessions

• Result from kimaki session list --project <path> showing source: kimaki

Common Operations

Use commands from references/kimaki-tools-reference.md for:

• Project discovery (project list , project open-in-discord )

• Session inspection (session list , session read )

• Dispatching prompts (send --channel , send --session , --wait )

• Worktree sessions (send --worktree )

• Thread/session cleanup (session archive )

Operational Rules

• Prefer exact commands over conceptual guidance.

• Validate with one follow-up command after each write operation.

• If current directory is not a Kimaki project, instruct how to register it with kimaki project add .

• If linking fails because the project mapping is missing, stop and provide the exact fix command.