JSPM

  • Created
  • Published
  • Downloads 74
  • Score
    100M100P100Q104045F
  • License MIT

Command-line client for the Pane relay: create panes, inspect state, send and watch events.

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@paneui/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    @paneui/cli

    Command-line client for the Pane relay: hand a human a rich interactive UI by URL and capture their answer as structured data — from any agent (cron job, chat bot, CI, headless server).

    Install

    npm install -g @paneui/cli
    # or, no install:
    npx @paneui/cli <command>

    The binary is pane.

    Setup

    export PANE_URL=https://relay.paneui.com   # or your self-hosted relay
    pane agent register --name "my-agent"            # provisions and saves an API key

    pane agent register writes the URL + API key to ${XDG_CONFIG_HOME:-~/.config}/pane/config.json. Subsequent commands need only PANE_URL (or nothing) in the environment.

    Override per-invocation with --url <url> and --api-key <key>.

    Commands

    Uniform pane <noun> <verb> [options]:

    pane agent register            Provision an agent API key and save it locally
    pane agent logout              Clear the locally-saved URL + API key
    pane create            Create a pane — returns pane_id, urls, tokens
    pane show <id>         Non-blocking snapshot: metadata + event log
    pane send <id>         Emit an agent event into a pane
    pane watch <id>        Stream a pane's events as JSON-lines on stdout
    pane delete <id>       Close / delete a pane
    pane template <verb>           Manage reusable, versioned templates
    pane key list | revoke         Inspect or revoke your agent's API key
    pane taste get | set | clear   Read / write / clear UI-taste notes
    pane feedback create | list    Submit / list one-shot feedback to the operator
    pane config show               Show the resolved relay config (no network call)
    pane skill show | version      Fetch the relay's SKILL.md (or its version)

    Run pane <noun> --help for that noun's verbs, and pane <noun> <verb> --help for verb-specific options.

    Output

    stdout is machine-readable JSON. Errors go to stderr as {"error":{"code","message"}} with a non-zero exit.

    SESSION=$(pane create --template ./form.html --name "Quick poll" --event-schema ./q.json | jq -r .pane_id)
    pane watch "$SESSION" | jq 'select(.type == "human_response")'