onako 0.4.3

Dispatch and monitor Claude Code tasks from your phone

Onako

Dispatch and monitor Claude Code tasks from your phone.

Onako is a lightweight server that runs on your machine. It spawns Claude Code sessions in tmux, and you monitor them through a mobile-friendly web dashboard. Fire off tasks from an iOS Shortcut or the dashboard, check in from anywhere.

Install

pipx install onako

Requires tmux and Claude Code.

Usage

onako                              # starts server, drops you into tmux
onako --session my-project         # custom session name

If you're already inside tmux, onako auto-detects your session and skips the attach. Open http://localhost:8787 on your phone (same network) or set up Tailscale for access from anywhere.

onako stop                         # stop the server
onako status                       # check if running
onako serve                        # foreground server (for development)
onako version                      # print version

Adopting existing tmux windows

If you already have work running in another tmux session, move those windows into onako's session so they show up in the dashboard:

tmux move-window -s <session>:<window> -t onako

How it works

Onako monitors all tmux windows in the configured session. Windows it creates (via the dashboard) are "managed" tasks. Windows created by you or other tools are discovered automatically as "external" — both get full dashboard support: view output, send messages, kill.

Task state is persisted in SQLite so it survives server restarts.