Upivia Terminal · one command

The governed
agent terminal.

A full-screen terminal built on Textual. Chat with Yupi, watch agents delegate work, and edit files on your machine — every action metered, policy-checked, and audited.

Runs on macOS, Linux, and Windows (WSL). Requires Python 3.10+. Install in one line.

Install now →Read the CLI docs
uv or pipx
1 command to install
100% local file access
live web ↔ terminal sync
Install

Pick your installer. Both take one line.

The TUI ships as the upivia-tui package. Use uv or pipx for an isolated environment, then authenticate with a Personal Access Token.

uv
$ uv tool install upivia-tui
Installed 1 executable: upivia-tui

$ upivia-tui init
✓ Authenticated
pipx
$ pipx install upivia-tui
installed package upivia-tui

$ upivia-tui
launching TUI…

Everything, in your terminal.

Streaming chat

Full-screen Textual TUI with live token streaming and a command palette.

Local file tools

Read, write, edit, search, and run files on your machine — governed and audited.

Syntax-highlighted diffs

OpenCode-style edit diffs so you see exactly what changed before it lands.

Multi-agent delegation

Watch agents hand work to each other in a live Team panel with per-agent budgets.

Realtime session sync

Web ↔ terminal sessions stay in lockstep; pick up where you left off anywhere.

Background device mode

Keep this machine online so the web app can edit its files remotely.

Quick start

01

Install

One line with uv (or pipx).

uv tool install upivia-tui
02

Authenticate

Enter your platform URL and PAT.

upivia-tui init
03

Launch

Open the full-screen terminal.

upivia-tui

You'll need a Personal Access Token from Settings → Access Tokens. Prefer to stay online as a device? Run upivia-tui --background so the web app can edit files on this machine.

Step-by-step walkthrough

Tutorial1 / 6
$ python3 --version
Python 3.12.0
$ uv tool install upivia-tui
Installed 1 executable: upivia-tui
$ upivia-tui --help
usage: upivia-tui [-h] [--background] [--dir DIR] {init,whoami}

Install Python + the TUI

The TUI requires Python 3.10 or later. Install it with uv (or pipx).

Reference

Every command.

A handful of subcommands. Launch the full TUI, authenticate, root it at a project, or run headless as a device.

Full CLI documentation →

upivia-tui --help
upivia-tui              launch the full-screen TUI (default)
upivia-tui init         first-time setup: auth + workspace
upivia-tui --dir PATH   launch rooted at a project directory
upivia-tui --background headless device — edit files from web
upivia-tui whoami       check current authentication

Ready to build with AI agents?

Install the CLI, connect your account, and deploy governed agents today.

Create a free account →Read the docs