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.