Skip to content

Quick start

Already installed? Here's how to fire your first notification and tune the experience. New to NHJ? Start with Requirements & tiers and Install profiles.

Your first notification

nhj test ok                              # fire a "done" across every configured channel
nhj test err --message "something broke" # an error — routes to Karren

If you hear a voice (or feel a buzz / see a tile), you're wired up. nhj test only confirms the event was queued — if nothing renders, the channel is the issue, not the queue; see Configuration and nhj devices.

See what's configured

nhj voices     # the cast — bundled bank availability + live-TTS references per voice
nhj devices    # the notification channels NHJ found and can reach
nhj status     # current mode, dials, mute/muzak, censor

Tune it live — no restart

Every setting takes effect on the next vibe. You can run these directly, or just ask Claude in plain language ("make Jan more bogan", "switch to call-centre mode").

nhj set jan.ockerism 11      # any character dial — jan.competence, bazza.stress, karren.karren…
nhj mode rave                # one-word vibe switch — rave | call-centre | quiet | special-forces | went-full-bogan
nhj muzak on                 # hold music while the agent works
nhj mute                     # silence everything;  nhj unmute to restore

→ Full dial reference: Characters & dials · the mode macros: Modes

Faster playback (optional)

nhj build-bank --voice jan   # pre-render a voice's bank so lines play instantly

Uninstall

One command stops the TTS/LLM/MCP services and removes everything NHJ installed (runtime, config, downloaded models/media, the nhj launcher, and NHJ's Claude hooks/MCP/markers/skill). Your Claude install is left intact. No sudo.

nhj uninstall                # add --yes to skip the confirmation