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 "" # 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.