Otto Docs

The Mac

The workspace probe, the project registry, music control, and the dev-life watchers that read them.

The workspace probe

One line answering what you are actually doing: the frontmost application, the repo you are in and whether it has uncommitted changes, and what is playing.

It feeds the Machine section of the brief, and it is what lets Otto tell the difference between you being at the keyboard and away without installing anything that watches you.

The project registry

A nightly scan of your projects directory writing one record per repo:

  • the normalised git remote
  • package manager and lockfile paths
  • CI workflow files
  • deploy URLs and domains, read from config files only, never guessed
  • last tag and last commit

Every dev-facing watcher reads this instead of re-deriving it. You feel it as Otto knowing that a project name means a repo, a launchd job and a live URL, rather than a word you said.

Music

A CLI drives the Music app on the Mac: status, play, pause, next, previous, volume, seek, shuffle, repeat, search, playlists, queue, favourite, rate.

Library only. It cannot reach the streaming catalogue, so a song you have not saved cannot be played, and Otto says so rather than pretending.

Playback is audible in your house. Otto does not start, skip or stop anything you did not ask for, and never as a side effect of another task. Before a spoken reply plays, the volume ducks and is restored afterwards, so Otto does not talk over your music.

Installing the shell hook

The long-command ping is a zsh hook rather than something the channel can turn on by itself. Source it from your shell config:

source /path/to/otto-core/scripts/otto-shell-hook.zsh

It reports a foreground command that ran longer than ninety seconds and finished while the terminal was not frontmost. Interactive things that are supposed to run for hours are ignored by default: editors, pagers, ssh, tmux, REPLs, and git commit. OTTO_HOOK_MIN_SECS and OTTO_HOOK_IGNORE tune it.

On this page