Metadata-Version: 2.4
Name: onako
Version: 0.4.2
Summary: Dispatch and monitor Claude Code tasks from your phone
Author: Amir
License-Expression: MIT
Project-URL: Repository, https://github.com/AzRu/onako
Keywords: claude,claude-code,tmux,orchestrator,ai
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastapi>=0.100.0
Requires-Dist: uvicorn>=0.20.0
Requires-Dist: click>=8.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: httpx>=0.24.0; extra == "dev"

# 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

```bash
pipx install onako
```

Requires [tmux](https://github.com/tmux/tmux) and [Claude Code](https://docs.anthropic.com/en/docs/claude-code).

## Usage

```bash
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](https://tailscale.com) for access from anywhere.

```bash
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:

```bash
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.
