TINY(1)General Commands ManualTINY(1)

The fleet screen

Run tiny with no arguments:

    NAME        STATE      AGE   CPU    MEM  WHAT
  ✳ s-x7k2f     needs you  12m   84m  512Mi  May I force-push the rebased branch?
  ● api-fix     running     3h  212m  1.1Gi  migrating auth tests to vitest
  └ ● api-db    running    41m  907m  2.9Gi  rewriting migrations in golang:1.26
  ● night-run   running     8h    1m  301Mi  ⏸ Usage limit reached · continuing at 5:20pm
  ✓ readme      done        2d
  · ✉ broadcast to all…
  · + new session
  · ⚙ new session with options…
  · ☰ namespace settings
  · ✕ quit

Reading it

  • WHAT is live. It shows the agent's own declared title, refreshed as it works. A paused session says why and when it resumes; a session with a bad token quotes the agent's own error message.
  • CPU/MEM are self-reported by each session from its own cgroup, so the screen works without metrics-server or extra RBAC.
  • ✳ means a question waits. Rows keep creation order on purpose, so nothing jumps around when a question arrives.
  • Children render under their parent (└).

Keys

key what
enter attach (also tiny attach <session> from a plain shell); on an idle "waiting for you" row, attaching clears the mark
a answer the selected ✳ — answering is acting
m message the selected session (durable inbox)
b broadcast to every unfinished session
n / o new session — blank / the full options form
d, then y delete (two keystrokes on purpose: a session is a workspace and a transcript)
r refresh

Drop a file onto the terminal — fleet screen or attached — and it streams to /workspace/uploads/ with live progress; the agent gets the path.

What did they change?

The fleet screen says what each session is doing; tiny diff says what it has done:

$ tiny diff
  root           on tiny/issue-1   3 files +100/-3
  night-run      on tiny/issue-9   7 files +210/-44

  touched by more than one session
    internal/auth.go                       night-run, root

It reads each workspace live over the exec API — committed work on the session's branch, dirty files, untracked additions, and any bundles waiting in the outbox. Naming one session (tiny diff night-run) lists its files; the bare form summarizes the fleet and flags files two sessions are both editing, which is the collision nothing else warns you about.

Namespace settings

☰ toggles the add-ons: registry cache, artifact store, GitHub runner. Your client applies each one with your credentials when you flip it.