Status mascot
A compact emoji display: all good, update available, unconfigured, error or installing.
Visual & diagnostics
Real-time Buddy and sth doctor
STH makes your skills' state visible and alive. Buddy changes expression with the project state, and sth doctor checks everything that could go wrong.
$ sth buddy --watch
💧
╭─────╮
│ >/< │
╰─────╯
Tout est à jour.
[fsnotify] agents/reviewer/SKILL.md modifié…
⚠️ Mise à jour disponible.
$ sth doctor
✔ Configuration projet
✔ Fichier d'état
✔ Identifiants disponibles
✔ Provider joignableWhat you can do
--watch mode
sth buddy --watch monitors .sth/ and the target folder with fsnotify and reacts as soon as a file moves.
sth doctor
Four independent checks: project config, state file, available credentials and provider reachability, with remediation hints.
Built for the terminal
Shell completion (bash, zsh, PowerShell) and tidy output that stays readable in any terminal.
Frequently asked questions
- Does Buddy use resources continuously?
- Only in --watch mode. Without --watch, Buddy prints a one-off state and exits.
- What does sth doctor check?
- Project config validity, state-file integrity, credential availability and provider reachability.
- Is shell completion available?
- Yes, via sth completion bash|zsh|powershell sourced into your shell.