babysit

A transparent PTY wrapper that runs a shell command and exposes it to external AI agents (Claude Code, Codex, …) via plain babysit subcommands.

$ babysit -- make local-ci
babysit session ab12: make local-ci
  babysit log -s ab12 --tail 200
  babysit status -s ab12
Running tests...
✓ test_a
✗ test_b: assertion failed
make: *** [local-ci] Error 1
$ echo $?
2

babysit run make local-ci is the explicit form (and the one that accepts --name); behaves identically.

There is no TUI, no alt-screen, no key grabbing. Output streams straight to your terminal and stays in scrollback. Ctrl-C, Ctrl-Z, Ctrl-D and every other keystroke flow through to the wrapped command exactly as if you ran it directly. Babysit exits with the same exit code as the wrapped command, and to "quit babysit" you just kill the wrapped command (Ctrl-C, exit, etc.).

The session id printed at the top is the only thing babysit adds. Paste it into a Claude or Codex session running in another terminal:

"hey, can you tell me if anything goes wrong on babysit session ab12?"

The agent reads state via the subcommands below. babysit does no monitoring of its own — it just exposes the wrapped command as a small CLI/file API; the agent decides when and how to use it.

Subcommands

babysit -- <cmd> [args…]                    # wrap a command (short form)
babysit run [--name NAME] <cmd> [args…]     # wrap a command (named form)
babysit list [--json]                       # all sessions          (alias: ls)
babysit status -s <id> [--json]             # state of wrapped cmd  (aliases: st, info)
babysit log -s <id> [--tail N] [--raw]      # output, ANSI stripped (alias: logs)
babysit restart -s <id>                     # kill + respawn        (alias: r)
babysit kill -s <id>                        # terminate it          (alias: stop)
babysit send -s <id> "<text>"               # write text + newline  (alias: type)
babysit prune [--dry-run]                   # delete finished / dead sessions

-s <id> is shorthand for --session <id> and accepts either the id, a name set via --name, or the literal string latest. From inside the wrapped command itself the session is implicit via $BABYSIT_SESSION_ID, so the flag can be omitted.

status and log work even after babysit has exited — they fall back to the on-disk state files. restart, kill, and send need the live control socket and will fail if the babysit process is gone.

babysit <unknown> is treated as an unknown subcommand (with a did you mean …? hint), not as a wrap attempt — use babysit -- <cmd> or babysit run <cmd> to wrap.

Session state on disk

Each session writes to ~/.babysit/sessions/<id>/:

meta.json       # static info (cmd, started_at, …)
status.json     # live state (running / exited / killed, exit_code)
output.log      # raw bytes from the wrapped command's PTY
control.sock    # Unix socket the subcommands talk to

babysit list flags sessions whose owning babysit process has died as dead (e.g. crash, kill -9, reboot before a clean exit could be recorded). Run babysit prune to clear out anything that's no longer running.

Build

cargo build --release
# binary at target/release/babysit