SuperPi.CLI (super_pi v0.1.0)

Unified Command-Line Interface for Super-Pi-BEAM.

Provides a single, standardized CLI for all agent harnesses:

Supports --harness <id> (code, assistant, librarian, planner). --agent is a deprecated alias: self selects code, research selects planner.
Supports non-interactive -p / --prompt / --print and streaming turns (--input-format stream-json).
Supports conversation continuation (-c, --continue) and resumption (--conversation <id>).
Unified subcommands for harnesses, models, agents, mcp, plugins, remote-control, and session.
Guarantees clean process lifecycle management with synchronous registry unregistration on shutdown.

Summary

Functions

Harnesses as the agents entries of workspace.metadata. The key is kept for wire compatibility. Each entry has "id" and "description" plus the harness capabilities.

default_extensions()

execute_session(flags, positional, opts \\ [])

help_text()

launch_interactive_tui(conv_id, flags, workspace_dirs, opts \\ [])

models_catalog()

parse_args(argv)

Parses command-line arguments (argv) into {:subcommand, cmd, args, flags} or {:run, flags, positional}.

run(argv, opts \\ [])

Executes the parsed CLI command and returns {exit_code, output_string}.

slash_commands()

The slash commands that every interface lists: RPC workspace.metadata and ACP available_commands_update. Each is %{"name", "description"}.