--- name: happier-dev/happier-session-control source: https://app.decimal.ai/s/happier-dev-happier-session-control@1/SKILL.md source_sha256: a2443a19829a --- # 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 session list --json` - `happier --server-url --webapp-url session list --json` ## Contract All JSON outputs are a pure-stdout envelope: ```json { "v": 1, "ok": true, "kind": "...", "data": {} } ``` or: ```json { "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: ```bash happier auth status --json ``` ## Session Commands List sessions: ```bash happier session list --json ``` Inspect session status (server snapshot): ```bash happier session status --json ``` Inspect session status with a best-effort live refresh: ```bash happier session status --live --json ``` Create/load a session by tag: ```bash happier session create --tag --json ``` Send a message to a session: ```bash happier session send "" --json ``` Send a message and wait until the session is idle: ```bash happier session send "" --wait --timeout 300 --json ``` Wait for a session to become idle: ```bash happier session wait --timeout 300 --json ``` Stop a session: ```bash happier session stop --json ``` Read session history (compact is recommended for prompt stuffing): ```bash happier session history --limit 50 --format compact --json ``` ## Execution Run Commands Start an execution run: ```bash happier session run start --intent review --backend claude --json ``` List runs for a session: ```bash happier session run list --json ``` Get a run: ```bash happier session run get

--include-structured --json ``` Send input to a run: ```bash happier session run send

"" --json ``` Stop a run: ```bash happier session run stop

--json ``` Execute an action on a run: ```bash happier session run action

--input-json '' --json ``` Wait for a run to finish: ```bash happier session run wait

--timeout 300 --json ``` Stream turn IO for a streaming run (e.g. `intent=voice_agent`): ```bash happier session run stream-start

"" --json happier session run stream-read

--cursor 0 --json happier session run stream-cancel

--json ``` ## Server Commands (JSON) List server profiles: ```bash happier server list --json ``` Current active server: ```bash happier server current --json ``` Add a server profile non-interactively: ```bash happier server add --name "My Server" --server-url https://example.com --webapp-url https://example.com --use --json ``` Switch active server: ```bash happier server use --json ``` Remove a server profile: ```bash happier server remove --force --json ``` Probe server reachability/version: ```bash happier server test [] --json ``` Set a one-off custom server as active: ```bash happier server set --server-url https://example.com --webapp-url https://example.com --json ```