Skip to content

limactl-menu: add a form for creating new instances - #5629

Open
AkihiroSuda wants to merge 1 commit into
lima-vm:masterfrom
AkihiroSuda:fix-5595
Open

AkihiroSuda wants to merge 1 commit into
lima-vm:masterfrom
AkihiroSuda:fix-5595

Conversation

@AkihiroSuda

@AkihiroSuda AkihiroSuda commented Oct 15, 2026 •

Copy link
Copy Markdown
Member

What This PR Changes

Add a form for creating new instances.

image

Linked Issue (Required in most cases)

Closes #5595

How I Tested This

Manually ran limactl menu

AI Usage

Assisted-by: Claude Opus 5.5 (1M context)

@AkihiroSuda AkihiroSuda added this to the v2.3.0 milestone Oct 15, 2026
@AkihiroSuda
AkihiroSuda force-pushed the fix-5595 branch 2 times, most recently from 732579a to 195c202 Compare October 16, 2026 18:14
@AkihiroSuda
AkihiroSuda marked this pull request as ready for review October 19, 2026 02:56
@AkihiroSuda
AkihiroSuda requested a review from a team October 20, 2026 19:14
Press `c` or F7 in the instance list (or "Create Instance" in the
empty state) to open a form for the instance name, template, CPUs,
memory, disk, VM type, and whether to start the instance after
creation. Empty fields fall back to the template defaults.

The other `limactl create` flags (mounts, networks, port forwards,
`--set`, `--param`, etc.) are available in the "Details" section, which
is hidden by default. Its fields are generated from the flag
definitions of `limactl create`, and the description of the focused
field is shown below the form.

To minimize free-text input, the values are chosen from dropdowns
whenever the choices are known: the shell completion values of the
flags, the drivers, and the image variants of the selected template.
"Other..." in a dropdown allows entering a value that is not in the
list.

"Create" runs `limactl start` (or `limactl create`) with the
corresponding flags. "Edit" opens an editor for the template YAML with
the form values applied, and then creates the instance from the edited
YAML. In both cases, the menu is suspended while limactl is running, and
the new instance is selected when returning to the menu.

The form can be navigated with the arrow keys as well as with Tab:
Up/Down move between the fields and the buttons (except in an open
dropdown list, and except between the lines of a text area), and
Left/Right move between the buttons.

The single-key shortcuts of the instance list are now only handled
while the list has the focus, so that they do not interfere with typing
into the form.

Fixes lima-vm#5595

Assisted-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

limactl menu: add an UI for creating new instances

1 participant