Agent skill

happier-session-control

Manage Happier sessions (list/status/send/wait/history/stop + execution runs) via the happier CLI JSON contract.

View SKILL.md on GitHub Repository
Stars 649
Forks 49

Install this agent skill to your Project

npx add-skill https://github.com/happier-dev/happier/tree/dev/skills/happier-session-control

Metadata

Additional technical details for this skill

openclaw 
{
    "homepage": "https://github.com/happier-dev/happier",
    "requires": {
        "bins": [
            "happier"
        ]
    }
}

SKILL.md

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:

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 <session-id-or-prefix> --json

Inspect session status with a best-effort live refresh:

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

Create/load a session by tag:

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

Send a message to a session:

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

Send a message and wait until the session is idle:

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

Wait for a session to become idle:

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

Stop a session:

bash
happier session stop <session-id-or-prefix> --json

Read session history (compact is recommended for prompt stuffing):

bash
happier session history <session-id-or-prefix> --limit 50 --format compact --json

Execution Run Commands

Start an execution run:

bash
happier session run start <session-id-or-prefix> --intent review --backend claude --json

List runs for a session:

bash
happier session run list <session-id-or-prefix> --json

Get a run:

bash
happier session run get <session-id-or-prefix> <run-id> --include-structured --json

Send input to a run:

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

Stop a run:

bash
happier session run stop <session-id-or-prefix> <run-id> --json

Execute an action on a run:

bash
happier session run action <session-id-or-prefix> <run-id> <action-id> --input-json '<json>' --json

Wait for a run to finish:

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

Stream turn IO for a streaming run (e.g. intent=voice_agent):

bash
happier session run stream-start <session-id-or-prefix> <run-id> "<message>" --json
happier session run stream-read <session-id-or-prefix> <run-id> <stream-id> --cursor 0 --json
happier session run stream-cancel <session-id-or-prefix> <run-id> <stream-id> --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 <id-or-name> --json

Remove a server profile:

bash
happier server remove <id-or-name> --force --json

Probe server reachability/version:

bash
happier server test [<id-or-name>] --json

Set a one-off custom server as active:

bash
happier server set --server-url https://example.com --webapp-url https://example.com --json

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

happier-dev/happier

happier-session-control

Manage Happier sessions (list/status/send/wait/history/stop + execution runs) via the happier CLI JSON contract.

649 49
Explore
happier-dev/happier

happier-testing

Repo-specific TDD and test-validation workflow for Happier changes, with lane selection, fixture policy, and anti-flake guardrails.

649 49
Explore
happier-dev/happier

happier-github-ops

Run GitHub CLI commands as the Happier bot account via `yarn ghops` (forced PAT auth + non-interactive).

649 49
Explore
davila7/claude-code-templates

verl-rl-training

Provides guidance for training LLMs with reinforcement learning using verl (Volcano Engine RL). Use when implementing RLHF, GRPO, PPO, or other RL algorithms for LLM post-training at scale with flexible infrastructure backends.

23,776 2,298
Explore
davila7/claude-code-templates

openrlhf-training

High-performance RLHF framework with Ray+vLLM acceleration. Use for PPO, GRPO, RLOO, DPO training of large models (7B-70B+). Built on Ray, vLLM, ZeRO-3. 2× faster than DeepSpeedChat with distributed architecture and GPU resource sharing.

23,776 2,298
Explore
davila7/claude-code-templates

gguf-quantization

GGUF format and llama.cpp quantization for efficient CPU/GPU inference. Use when deploying models on consumer hardware, Apple Silicon, or when needing flexible quantization from 2-8 bit without GPU requirements.

23,776 2,298
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results