vibebuddy-moment

/vibebuddy-moment

moments are short transient overlays the buddy throws when something specific happens (tests passing, error loops, the welcome on first install). each lasts 3-8s, overrides quip + motion, and optionally swaps the title bar. distinct from scenes (ambient backdrop) and states (ongoing mood). full reference: cat assets/scenes/MOMENTS.md.

Common actions

1. see all 15 registered moments:

vibebuddy moment list

2. fire a moment manually:

vibebuddy moment fire tests_passed

3. bypass cooldown (useful when iterating):

vibebuddy moment fire tests_passed --force

4. preview a moment without the daemon (one-shot ratatui render):

vibebuddy moment preview welcome

5. is one active right now?

vibebuddy moment status

6. dismiss the active moment immediately:

vibebuddy moment cancel

7. disable the whole moment layer at runtime:

vibebuddy moment off

what ships in v0.4

15 built-in moments, registry-defined. user-defined moments land in v0.5 — until then, themes can override the quip pool per moment via a [moments.<id>] block in meta.toml (see assets/themes/windowcat/meta.toml for a sample).

heads up

• banners default OFF in v0.4. enable with moments_banners = true in ~/.config/vibebuddy/config.json. without it, the title bar stays put and moments still render quip + motion + accent.
• statusline mode shows compact moment text (banner or id, 24-char cap) via the cache file at $XDG_RUNTIME_DIR/vibebuddy.moment. line.rs reads the cache file directly and never imports the moments module.
• want the full id / trigger / banner table? cat assets/scenes/MOMENTS.md.

(quietly, kindly: ~‿~)