Metadata-Version: 2.4
Name: onako
Version: 0.2.0
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
cd ~/projects
onako serve
```

Open http://localhost:8787 on your phone (same network) or set up [Tailscale](https://tailscale.com) for access from anywhere.

### Run in the background

```bash
onako serve --background
```

This installs a system service (launchd on macOS, systemd on Linux) that starts on boot. Tasks run in the directory where you ran the command.

```bash
onako serve --background --dir ~/projects   # override working directory
onako status                                 # check if running
onako stop                                   # stop the background service
onako version                                # print version
```

## How it works

Each task is a tmux window running an interactive Claude Code session. The web dashboard reads tmux output and lets you send messages to running sessions. Task state is persisted in SQLite so it survives server restarts.
