[cdalar]

What

A port of boxctl's tui (boxctl-io/boxctl-cli#130, #131) onto onctl's provider interface. Same stance as there: every action is what the subcommand does, nothing else in the CLI changes.

• Header: info block (provider, VMs by state, what's showing, last refresh with a spinner while busy, rev), the current view's hotkeys as <key> label columns, and an onctl logo on the right. Hidden on terminals under 18 lines.
• Views via the : prompt: :vms (default), :images, :sizes, plus :create, :ssh <vm>, :help, :q. :vms web opens filtered.
• Table: one bordered box titled VMs(all)</filter>[count], sorted column marked ↑/↓, cursor row highlighted, coloured STATE column, 0/1/2 for all/running/paused (ls's two sections). shift+letter sorts by that column.
• Pages: enter/d describe (a kubectl describe layout: IP, type, image, location, SSH port, created, cost; follows the VM on refresh), y the VM as JSON, ? help. Esc pops; crumbs at the bottom show the stack.
• Actions: s runs onctl ssh <vm> as a child process (the alternate screen is left for it) with the resolved --provider and any root flags passed along; p is provider.Pause by name; r is CreateSSHKey + Resume as resume.go does it; ctrl-d is provider.Destroy after destroy's question. Pause is refused on a paused VM, resume on a live one, and nothing runs twice while an action is in flight.
• Create (c): a form with name, image and type. Each is typed, and ←/→ walks image/type through what the provider's images/sizes list when it lists them; empty fields leave the flag off so onctl create's own defaults apply. Enter runs onctl create in the foreground with those flags, so create's output and waits show as usual. c from :images or :sizes fills in that row.
• The list refreshes every 5s; an action's completion refreshes at once.

Also: ls's running/paused partition moves into listVMs so ls and the tui agree on which VMs count as paused. Provider log lines are kept off the screen while the tui runs (ONCTL_LOG sends them to a file whose name is printed on exit).

boxctl-only views and keys (urls/expose, backups/restore, keep, goal logs) have no onctl equivalent and are left out.

Dependencies

Adds charmbracelet/bubbletea, bubbles (textinput, spinner) and lipgloss. spf13/pflag becomes a direct dependency (it was already there via cobra).

Testing

• cmd/tui_test.go drives the model against a fake provider: rows/sort/filter/state filter, keys arriving batched, refusals on paused and pending VMs, r → CreateSSHKey then Resume, the destroy dialog → Destroy, describe/json pages and VM keys from them, :images/:sizes/:vms web, unknown commands, :q, partial listing errors, the child-process exit message, the child args (provider + changed root flags), the create form (catalog walking, existing-name refusal, the onctl create command line, preselection from :sizes).
• Rendered the real binary in a pseudo-terminal against the local ac provider at 100x26 and 70x16: list, help, :sizes, :images, the create form, flash messages. (The ac listing itself fails on this machine with "unexpected output from the container CLI", on main too; the tui shows it as a flash.)
• go vet, gofmt, golangci-lint, Linux and Windows cross-builds: clean. Full cmd test package passes.

🤖 Generated with Claude Code

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	golang/​github.com/​charmbracelet/​bubbletea@​v1.3.10
	golang/​github.com/​charmbracelet/​bubbles@​v1.0.0
	golang/​github.com/​charmbracelet/​lipgloss@​v1.1.0

View full report

[codecov]

Codecov Report

❌ Patch coverage is 78.55015% with 216 lines in your changes missing coverage. Please review.
✅ Project coverage is 45.70%. Comparing base (cb8c258) to head (53d6b96).

Files with missing lines	Patch %	Lines
cmd/tuiactions.go	63.42%	94 Missing ⚠️
cmd/tui.go	76.23%	52 Missing and 1 partial ⚠️
cmd/tuirender.go	87.50%	33 Missing ⚠️
cmd/tuicreate.go	82.94%	22 Missing ⚠️
cmd/tuiviews.go	93.27%	8 Missing ⚠️
cmd/list.go	60.00%	6 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1210      +/-   ##
==========================================
+ Coverage   41.25%   45.70%   +4.45%     
==========================================
  Files          69       74       +5     
  Lines        7560     8554     +994     
==========================================
+ Hits         3119     3910     +791     
- Misses       4441     4643     +202     
- Partials        0        1       +1     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.