Metadata-Version: 2.4
Name: onako
Version: 0.6.1
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 clean                        # remove worktrees for finished tasks
onako reset                        # full teardown: stop, kill session, clean worktrees
onako serve                        # foreground server (for development)
onako version                      # print version
```

### Dispatching tasks from the CLI

```bash
onako task "fix the login bug"                          # create a task
onako task "add tests" --branch feat/tests              # run in a git worktree
onako task "refactor auth" --branch feat/auth --base-branch develop
```

### Flags

```bash
onako --dangerously-skip-permissions    # skip Claude Code permission prompts
onako --no-attach                       # start server without attaching to tmux
onako --dir /path/to/project            # set working directory for tasks
```

### 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.
