WokiToki (toki)

WokiToki is a local, blocking feedback CLI the AI invokes mid-conversation. It serves a dark web UI, opens the browser, waits for the user to answer, and on submit prints a single Result JSON to stdout that the AI parses the same turn. The branding is "walkie-talkie": back-and-forth, one answer per thing. Command = toki; all tool output lands under ~/.toki/.

This skill is installed user-level (global): it loads automatically in every project, with no per-repo wiring. Because every file it writes goes under ~/.toki/ (never the cwd), running toki inside any repo leaves zero footprint in that repo — no .gitignore edits needed.

Everything is one engine: a spec is a list of blocks. A block with controls is a question; a block without controls is a report paragraph; mixing them in one spec is a hybrid form — for free.

Phase 0 — first-run binary check (before the first invocation in a session)

toki ships as source and is compiled to a single global binary on first use. Before invoking it the first time, ensure the binary exists; build it if missing:

command -v toki >/dev/null 2>&1 || bun build --compile "<skill-dir>/cli/index.ts" --outfile "$HOME/.bun/bin/toki"

• <skill-dir> is this skill's install directory — user-level that is ~/.claude/skills/wokitoki.
• ~/.bun/bin is already on PATH for Bun installs, so the freshly built toki is immediately runnable.
• Fallback (if --compile is unavailable or the binary can't be written): run from source with bun "<skill-dir>/cli/index.ts" <specPath> — identical behavior, just a slower cold start.