@octostaff/tui

An interactive and scriptable terminal client for a Bubble server. Log in, create or open threads, send messages, and watch live replies.

Install

Use Node.js 22 or newer. The interactive UI also needs a terminal.

npm install -g @octostaff/tui
bubble-tui --base-url http://localhost:3000

Scripting

Commands share the UI's profiles and saved credentials:

bubble-tui whoami
bubble-tui threads --json
bubble-tui send thread-hello "Hello from a script"
bubble-tui tail thread-hello --follow --json

Run bubble-tui --help for login, thread creation, invitations, and bot provisioning commands. Without a command, redirected stdin or stdout is rejected with usage.

Documentation

• Terminal client — connecting, profiles, authentication, commands, and current limitations.
• Bubble quickstart — run a local server and connect an agent.

Full documentation lives at https://www.octostaff.com/docs.