1
Install Poko
Download and install it like a normal desktop app. Windows x64 is the current direct-download release; Windows ARM64, macOS, and Linux builds are on the way.
Getting started
How to Use Poko
Poko is easiest to understand as a local desktop companion for coding-agent workflows. Install it, connect the agent tools you already use, and let it surface what’s happening live.
2
Launch Poko
When Poko starts, it runs as a desktop-native companion instead of a traditional main-window app. Its job is to stay close to your work, not replace it.
3
Connect an agent
Open Settings, go to Agents, install or enable the integration you want, then resume work in that agent and watch Poko reflect the session state live.
4
Understand what Poko is showing
Poko’s desktop presence changes based on what your agent is doing. Thinking means planning, working means active tool use, notification or attention means human awareness is needed, idle or done means the current task has settled, stale flags a session gone quiet whose process is still alive, and crashed flags one whose process died — it clears itself automatically a couple of minutes later.
5
Use the Dashboard and HUD
Use the Dashboard for fuller session visibility: an expandable Context Brief per session (last prompt, latest output, changed files, next action), recent activity, focus actions, and explain-the-run flows. Use the HUD for compact live awareness beside the desktop character.
6
Use Steward features when they appear
Depending on the workflow, you may see mission briefs, pending Steward decisions, waiting reasons, handoff summaries, replay surfaces, and readiness-style reports. Turn on AI-powered summaries in Settings to layer an AI-written brief on top of the built-in explain-the-run report.
7
Customize the experience
You can adjust theme and variants, voice behavior, animation behavior, agent-specific settings, and session visibility preferences to make Poko feel like part of your own setup.
8
Use advanced surfaces only when needed
Poko also includes broader coordination surfaces like a remote-SSH session bridge, a mobile companion, Telegram-based remote approval, diagnostics, and Steward or replay tooling. Start with the live desktop experience first and add more only when the workflow calls for it.
9
If something looks wrong
Check whether the integration is installed and enabled, open the Dashboard to inspect session state, and use Doctor-style diagnostics if available. Poko is designed to make these flows easier to debug without forcing you to guess where the signal broke.
Best way to start
Start small: install Poko, connect one agent, and use the desktop presence plus Dashboard first. Everything else builds from that foundation.