CapTP CLI

Use the CLI to call capabilities, host a peer, or inspect a live session in the REPL. It also provides tools for AI assistants over MCP (Model Context Protocol). The CLI guide lists the commands and options.

Install CLI + Rooms in one command. It verifies the download against the release checksums before running the installer inside the archive:

curl -fsSL https://glowcap.org/install.sh | sh

GitHub Releases has the same glowcap-vVERSION-ARCH-OS.tar.gz archives to install by hand, and the glowcap-c- download contains the C SDK for building applications.

List the commands:

glowcap help

Join a room over iroh

To join rooms, first start a session. Rooms needs the complete installation, including its services and browser assets. Start a session that keeps its data in the folder you name. Its peers connect over iroh, an encrypted QUIC transport:

glowcap apps rooms session start --dir=./rooms-session

A local round-trip

ocapn listen binds loopback tcp, the testing transport: a cleartext host:port with no identity proof. The CLI’s demo greeter answers the verb greet with Hello, <arg>.

Each terminal sets its own GLOWCAP_STATE directory, so it acts as its own peer, and init creates the identity keys that peer signs its sessions with. Run terminal A first, then paste its printed locator (the peer’s dialable ocapn:// address) into LOC in terminal B. --publish serves one partner and then exits, and Ctrl+C or SIGTERM stops a waiting or serving listen cleanly with exit 0.

# terminal A
export GLOWCAP_STATE=/tmp/glowcap-a
glowcap --json init
glowcap --json ocapn listen --publish greeter
# {"ok":true,"locator":"ocapn://127.0.0.1%3A46659.tcp"}   (%3A is the : of host:port, URI-encoded)

# terminal B
export GLOWCAP_STATE=/tmp/glowcap-b
glowcap --json init
LOC='ocapn://127.0.0.1%3A46659.tcp'   # paste A's locator
glowcap --json ocapn call "$LOC" greeter greet world
#                         name──┘       │     └─ arg
#                         verb──────────┘
# {"ok":true,"value":"Hello, world"}

REPL, MCP, and completion

glowcap repl is an interactive CapTP session. Start it empty and dial from inside, or pass a locator to dial first. In a terminal it shows the session’s exports, imports, and answers beside the prompt as you type. Type guide for a staged walkthrough. The CLI guide has recipes for the REPL and for probe, which needs a live listener to dial.

glowcap mcp --tools default                # CapTP tools for an editor assistant (MCP)
eval "$(glowcap completion bash)"          # tab completion

For the library API behind these commands, continue to Start building. The demo apps use the same operations in a chat room, a task board, and a tool service.