TINY(1)General Commands ManualTINY(1)

The manual

Everything tiny does, one static page per topic.

START

Install — One binary, one wizard, no pods until your first session.

Try it in 5 minutes — A full run on a throwaway kind cluster, no real cluster needed.

Your first session — Start a task, close the laptop, come back to finished work.

Handoff — Move the local session you're in — files, dirty changes, transcript — to the cluster mid-conversation.

The fleet screen — One screen for the namespace, showing who runs and who is waiting on you.

THE LOOP

Issues to PRs — The GitHub wiring, copy-paste ready: label an issue, get back a pull request.

The outbox — How work leaves the cluster when agents hold zero credentials.

The gate — Dangerous decisions park as Kubernetes objects until a human answers.

SESSIONS

Claude & Codex — Claude Code and Codex, picked per session, signed in with the plan you already pay for.

Custom images — An init container injects the agent into any glibc image you name.

Spawning sessions — Sessions spawn specialist sessions, each approved through the gate.

Messages, broadcast & uploads — The durable inbox, broadcast, and drag-and-drop uploads.

ADD-ONS

Registry cache — One Docker Hub pull per image per namespace: 191s cold, 9s warm.

Artifact store — An S3-compatible store beside the sessions, one checkbox away.

GitHub runner — An in-cluster Actions runner so the loop's jobs run next to the fleet.

SECURITY

Threat model — What a hostile agent can and cannot do, stated plainly.

FAQ — The questions we'd ask, answered without spin.