~/blog/tutorial
tutorial2026-09-24Diagnosing Wakii failures: three layers, six situationsA diagnosis order from orca status through the terminal to logs, then the six failures you meet most: agents not starting, worktree creation failing, a missing CLI, dead SSH terminals, browser no tab, and GitHub rate limits.6 min readread→tutorial2026-09-23Wiring Linear and GitHub: issue to worktree, worktree to PRTwo connections in Settings → Integrations: create a worktree from an issue with a prefilled name and Linear's suggested branch name, per-team opt-in status sync, and an agent that reads Linear through orca linear.8 min readread→tutorial2026-09-23Running sessions side by side: split panes and per-worktree portsWatch several agents at once with nested split panes, keep a dev port per worktree, drive sessions from the CLI, and clean up when the work is done.6 min readread→tutorial2026-09-22Cloud relay: agents on a server you own, UI anywherePair two machines through a Remote Orca Server or orca serve — the server keeps the runtime, sessions, and agents; clients are just the UI. Plus pointing the CLI at a remote runtime and the safety rules.7 min readread→tutorial2026-09-22The worktree workflow: one task, one worktree, day to dayCreate, work, review, ship, and clean up a worktree in Wakii — picking the right start-from, sharing node_modules and .env across worktrees, the CLI table, and the way back to plain git when you need it.7 min readread→tutorial2026-09-21Your first custom skill: SKILL.md, try it, share itCreate a skill of your own — one directory, one SKILL.md file — verify it with orca skills installed, edit it without a build step, and share it behind a revocable unlisted link.7 min readread→tutorial2026-09-21SSH worktrees: keep the runtime local, run the work remoteAdd an SSH target, create the worktree on the remote machine, and keep the local feel: file-event sync, status chips, sessions that survive disconnects, port forwarding, and fixing a remote missing its toolchain.7 min readread→tutorial2026-09-20Your first story, end to end: what to click, what to typeA hands-on first run, step by step: state your idea in the ⚡ Workflow tab, watch impact and the plan land on Linear, follow SFs across the 🌳 Story bracket, answer gates B0–B5, and receive a single PR.8 min readread→tutorial2026-09-20Pair your phone with the Wakii desktop over QRInstall the Android app from the APK on GitHub Releases, scan the QR your desktop shows to pair, and put four things to work right away: the tiered story view, gate resolution with free-text + confirm, gate open/closed notifications, and guard codes.6 min readread→tutorial2026-09-19Installing and updating Wakii from zeroFrom an empty machine to a running app: check Node 24, pnpm and git, grab the version-named prebuilt download, understand what the first launch installs by itself — and always know exactly which release you are running.7 min readread→tutorial2026-09-07A tour of Wakii's public skillsWalk the /skills/ page and this site's own skills.ts: the public skills catalog in three groups, each card carrying its command, description, and how it works — with real grep transcripts so you can recount the numbers at reading time.9 min readread→tutorial2026-09-06Reviewing AI agents from your phone: Stories and decision gates in your pocketPair your phone with your desktop over a QR code, read story progress in the Stories tab, and resolve decision gates right from your phone — agents never wait for you to come back to the keyboard.3 min readread→tutorial2026-08-29Linear as external memory for the agent teamA chat log is a timeline, not a state — once the context window runs out, the agent loses everything. This post walks through the mechanism that makes Linear the team's external memory: sub-issue bodies written in a standard field frame, state written to be reproduced, and an audit trail that marks instead of deletes.8 min readread→tutorial2026-08-20Your first agent team has no setup stepOpen Wakii for the first time and the superpowers kit installs itself into ~/.claude/ — skills, nine agents, and the story-* command-line tools — without touching your existing config. This post takes the zero-setup mechanism apart: what ships in the kit, why re-running never breaks anything, and how to verify every claim with real commands.5 min readread→