acptui - A TUI for the Ambient Code Platform

The Ambient Code Platform gives you managed AI coding sessions backed by real workspaces, but the web UI isn’t always where I want to be when I’m already living in the terminal. So I built acptui — a terminal UI for browsing and managing Ambient Code Platform sessions without leaving the shell.

What it does

acptui starts with a project picker listing every project you have access to. Selecting one drops you into a session list showing phase, model, repo, and age at a glance. From there you can create, start, stop, or delete sessions, open a live chat view with streaming responses, browse workspace files, or check on background tasks — all without touching a browser.

The chat view streams assistant responses over SSE in real time, including collapsible thinking blocks you can expand with tab. You can export any conversation to markdown with ctrl+e, or open the session in the web UI with w if you need the full interface.

Session management from the CLI

Beyond the TUI, acptui create lets you spin up sessions programmatically:

acptui create my-project --prompt "Fix the flaky integration test" \
  --repo https://github.com/org/repo \
  --model claude-sonnet-4-6

There’s also acptui export for dumping conversations to markdown and acptui login for browser-based OpenShift OAuth authentication.

Filtering

The filter bar supports regex and field-specific prefixes, same pattern as cctv:

phase:Running                # match session phase
model:sonnet                 # match model name
repo:github.com/org/repo     # match repository URL
phase:Running model:sonnet   # multiple terms ANDed

Stack

Written in Go using the same Charm libraries as cctv — Bubble Tea for the TUI, Lip Gloss for styling, and Cobra for the CLI. Ships with five color themes (default, catppuccin, dracula, nord, light). Tests use Ginkgo.

Source and installation instructions at github.com/lyarwood/acptui. Issues and PRs welcome.

Contents

comments powered by Disqus