happier-session-control

Happier Session Control (CLI JSON)

This skill enables an agent framework (for example OpenClaw) to control Happier sessions using the existing happier CLI in --json mode.

Prerequisites

• The happier CLI is installed and authenticated.
• If using multiple servers/profiles, pass server selection flags before session (prefix-only):
  • happier --server <profile-id-or-name> session list --json
  • happier --server-url <url> --webapp-url <url> session list --json

Contract

All JSON outputs are a pure-stdout envelope:

{ "v": 1, "ok": true, "kind": "...", "data": {} }

or:

{ "v": 1, "ok": false, "kind": "...", "error": { "code": "..." } }

Common error codes to handle:

• not_authenticated: run happier auth login on the host (or mount/provide a valid HAPPIER_HOME_DIR).
• session_id_ambiguous: pick deterministically from error.candidates (prefer exact id; otherwise ask the user).
• session_not_found: call happier session list --json and retry.
• unsupported: feature disabled by server policy or backend doesn’t support the requested intent.

Auth Commands (JSON)

Check auth status without scraping human output:

happier auth status --json

Session Commands

List sessions:

happier session list --json

Inspect session status (server snapshot):

happier session status <session-id-or-prefix> --json

Inspect session status with a best-effort live refresh:

happier session status <session-id-or-prefix> --live --json

Create/load a session by tag:

happier session create --tag <tag> --json

Send a message to a session:

happier session send <session-id-or-prefix> "<message>" --json

Send a message and wait until the session is idle:

happier session send <session-id-or-prefix> "<message>" --wait --timeout 300 --json

Wait for a session to become idle:

happier session wait <session-id-or-prefix> --timeout 300 --json