feat(cli): completion, ssh commands, logs -f

[NovusEdge]

CLI and TUI polish. Items are numbered as in the QoL audit.

Changes

• feat(tui): in-TUI edit form, with guards on the destructive fields #5 completion. stoat completion bash|zsh|fish prints a script that calls a hidden stoat __complete. It completes subcommands, flags, enum values, VM names (data root plus the current project's keys), image ids and recipe names. Install steps are in docs/reference/cli.md.
• fix: cloud VMs were unusable — no console login, no disk room, wrong xfce user #9 ssh. stoat ssh <vm> <cmd...> runs the command over ssh. --json keeps its refusal, and the message now says stoat --json exec <vm> -- <cmd>.
• feat: recipe authoring, a richer image catalog, and a TUI that says what it's doing #10 logs. -f/--follow; --lines with -n kept and --n hidden for one release; no apply log yet for <vm> on stderr; stoat's own log defaults to INFO (STOAT_LOG_LEVEL=debug brings the trace back). --follow with --json is a usage error.
• feat: an interactive installer — just setup #11 defaults. create --help shows RAM, CPUs and disk from the core constants. The stoat init template uses the same constants. A create with no TTY on stdin, or with --json, records display = "vnc".
• feat(core): the core API — every VM operation off the TUI, with the CLI on top #12 TUI. Panes expand literal tabs. The footer and the ? panel wrap instead of truncating. The list hides the logo below 30 rows and uses the freed rows for VMs.
• One home for the recipe-marker wire format #15. images sizes columns from the data. doctor prints one line per check; -q prints only failures.

Completion approach

kong v1.16 has no completion support. I wrote it in about 200 lines with no new dependency. Grammar fields opt in with a complete:"vm|image|recipe" tag, and the completion logic is Go code with unit tests. The three shell scripts only forward the typed words.

Rejected, after checking each go.mod on the Go proxy:

• willabides/kongplete v0.4.0 (Nov 2023): built on kong 0.8.1, and pulls posener/complete, loginshell, go-multierror and yaml.
• jotaen/kong-completion v0.0.14: the same posener/complete, loginshell and multierror tree, and needs Go 1.25.
• go.abhg.dev/komplete v0.1.0: one release (Oct 2024), built on kong 1.2.1, adds shellwords.

Notes

• The display = "vnc" default applies to stoat create. VMs created from a stoat.toml by stoat up are not changed.
• stoat ssh --json vm cmd: --json after the VM name goes to the remote command, as with exec.
• Two existing tests changed. TestToastOverlayKeepsScreenShape now checks the toast against the terminal width, because the footer's last line is shorter now that it wraps. The list row budget takes the wrapped footer height into account.
• No VM was booted. The tests are unit and TUI model tests.

Verification

go vet, gofmt, golangci-lint run ./... (0 issues) and go test ./... pass. shellcheck is not installed here; no shell file changed.

[coderabbitai]

Warning

Review limit reached

Next included review available in 33 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Advanced

Run ID: e9c12997-a2c2-4ae1-b71a-5ca179d82fec

📥 Commits

Reviewing files that changed from the base of the PR and between ba413a3 and 3c7797c.

📒 Files selected for processing (20)

• docs/reference/cli.md
• docs/reference/tui.md
• internal/cli/cli.go
• internal/cli/complete.go
• internal/cli/complete_test.go
• internal/cli/grammar.go
• internal/cli/polish_test.go
• internal/cli/run_access.go
• internal/cli/run_image.go
• internal/cli/run_init.go
• internal/cli/run_misc.go
• internal/cli/run_state.go
• internal/cli/wire/envelope.go
• internal/logx/logx.go
• internal/tui/app.go
• internal/tui/keymap.go
• internal/tui/theme.go
• internal/tui/toast_test.go
• internal/tui/vmlist.go
• internal/tui/wrap_test.go

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}