Skip to content

[cli] Fix multipass find column widths: narrow Image, widen Aliases #5091

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Copilot wants to merge 5 commits into
base: main
Choose a base branch
from
Open

[cli] Fix multipass find column widths: narrow Image, widen Aliases #5091

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
0093020
[find] Improve table spacing distribution
Copilot Jul 17, 2026
8f1506a
[docs] Update missing find-output examples
ricab Jul 21, 2026
55bd1bd
[docs] Fix double-spaces
ricab Jul 21, 2026
d8b7e84
[docs] Drive-by typo fix
ricab Jul 21, 2026
914753c
[docs] Fix outdated find output
ricab Jul 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 13 additions & 13 deletions docs/how-to-guides/manage-instances/create-an-instance.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,19 +40,19 @@ Mounts: --
To find out which images are available, run `multipass find`. Here's a sample output:

```{code-block} text
Image Aliases Version Description
22.04 jammy 20260515 Ubuntu 22.04 LTS
24.04 noble 20260518 Ubuntu 24.04 LTS
25.10 questing 20260520 Ubuntu 25.10
26.04 resolute,lts,ubuntu 20260520 Ubuntu 26.04 LTS
core:core16 current Ubuntu Core 16
core:core18 current Ubuntu Core 18
core:core20 current Ubuntu Core 20
core:core22 current Ubuntu Core 22
core:core24 current Ubuntu Core 24
core:core26 current Ubuntu Core 26
debian trixie 20260601 Debian Trixie
fedora 20260422 Fedora 44
Image Aliases Version Description
22.04 jammy 20260705 Ubuntu 22.04 LTS
24.04 noble 20260705 Ubuntu 24.04 LTS
26.04 resolute,lts,ubuntu 20260720 Ubuntu 26.04 LTS
daily:26.10 stonking,devel 20260627 Ubuntu 26.10
Comment thread
ricab marked this conversation as resolved.
core:core16 current Ubuntu Core 16
core:core18 current Ubuntu Core 18
core:core20 current Ubuntu Core 20
core:core22 current Ubuntu Core 22
core:core24 current Ubuntu Core 24
core:core26 current Ubuntu Core 26
debian trixie 20260706 Debian Trixie
fedora 20260422 Fedora 44
```

To launch an instance with a specific image, include the image name or alias in the command, for example `multipass launch noble` to get an Ubuntu 24.04 instance:
Expand Down
36 changes: 18 additions & 18 deletions docs/reference/command-line-interface/find.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,19 +4,19 @@
The `multipass find` command without any argument lists the images Multipass can use to run instances with [`launch`](/reference/command-line-interface/launch) on your system and associated version information. For example:

```{code-block} text
Image Aliases Version Description
22.04 jammy 20260515 Ubuntu 22.04 LTS
24.04 noble 20260518 Ubuntu 24.04 LTS
25.10 questing 20260520 Ubuntu 25.10
26.04 resolute,lts,ubuntu 20260520 Ubuntu 26.04 LTS
core:core16 current Ubuntu Core 16
core:core18 current Ubuntu Core 18
core:core20 current Ubuntu Core 20
core:core22 current Ubuntu Core 22
core:core24 current Ubuntu Core 24
core:core26 current Ubuntu Core 26
debian trixie 20260601 Debian Trixie
fedora 20260422 Fedora 44
Image Aliases Version Description
22.04 jammy 20260705 Ubuntu 22.04 LTS
24.04 noble 20260705 Ubuntu 24.04 LTS
26.04 resolute,lts,ubuntu 20260720 Ubuntu 26.04 LTS
daily:26.10 stonking,devel 20260627 Ubuntu 26.10
core:core16 current Ubuntu Core 16
core:core18 current Ubuntu Core 18
core:core20 current Ubuntu Core 20
core:core22 current Ubuntu Core 22
core:core24 current Ubuntu Core 24
core:core26 current Ubuntu Core 26
debian trixie 20260706 Debian Trixie
fedora 20260422 Fedora 44
```

Launch aliases, version information and a brief description are shown next to each name in the command output.
Expand All @@ -35,14 +35,14 @@ The available aliases are:

The list of available images is updated periodically. The option `--force-update` forces an immediate update of the list from the servers, before showing the output.

The option `--show-unsupported` includes old Ubuntu images, which were available at some point but are not supported anymore. This means that some features of Multipass might now work on these images and no user support is given. However, they are still available for testing.
The option `--show-unsupported` includes old Ubuntu images, which were available at some point but are not supported anymore. This means that some features of Multipass might not work on these images and no user support is given. However, they are still available for testing.

The command also supports searching through available images. For example, `multipass find mantic` returns:
The command also supports searching through available images. For example, `multipass find resolute` returns:

```{code-block} text
Image Aliases Version Description
mantic 20240206 Ubuntu 23.10
daily:mantic 20240206 Ubuntu 23.10
Image Aliases Version Description
daily:resolute 20260720 Ubuntu 26.04 LTS
resolute 20260720 Ubuntu 26.04 LTS
Comment thread
ricab marked this conversation as resolved.
```

---
Expand Down
26 changes: 13 additions & 13 deletions docs/tutorial/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -328,19 +328,19 @@ Multipass has a great feature to help you get started with creating customised i

```{code-block} text
$ multipass find
Image Aliases Version Description
22.04 jammy 20260515 Ubuntu 22.04 LTS
24.04 noble 20260518 Ubuntu 24.04 LTS
25.10 questing 20260520 Ubuntu 25.10
26.04 resolute,lts,ubuntu 20260520 Ubuntu 26.04 LTS
core:core16 current Ubuntu Core 16
core:core18 current Ubuntu Core 18
core:core20 current Ubuntu Core 20
core:core22 current Ubuntu Core 22
core:core24 current Ubuntu Core 24
core:core26 current Ubuntu Core 26
debian trixie 20260601 Debian Trixie
fedora 20260422 Fedora 44
Image Aliases Version Description
22.04 jammy 20260705 Ubuntu 22.04 LTS
24.04 noble 20260705 Ubuntu 24.04 LTS
26.04 resolute,lts,ubuntu 20260720 Ubuntu 26.04 LTS
daily:26.10 stonking,devel 20260627 Ubuntu 26.10
Comment thread
ricab marked this conversation as resolved.
core:core16 current Ubuntu Core 16
core:core18 current Ubuntu Core 18
core:core20 current Ubuntu Core 20
core:core22 current Ubuntu Core 22
core:core24 current Ubuntu Core 24
core:core26 current Ubuntu Core 26
debian trixie 20260706 Debian Trixie
fedora 20260422 Fedora 44
```

`````{tab-set}
Expand Down
4 changes: 2 additions & 2 deletions src/client/cli/formatter/table_formatter.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ template <typename Dest>
void format_images(Dest&& dest,
const google::protobuf::RepeatedPtrField<mp::FindReply_ImageInfo>& images_info)
{
fmt::format_to(dest, "{:<28}{:<18}{:<17}{:<}\n", "Image", "Aliases", "Version", "Description");
fmt::format_to(dest, "{:<18}{:<28}{:<17}{:<}\n", "Image", "Aliases", "Version", "Description");
Comment thread
ricab marked this conversation as resolved.

auto sorted_images = images_info;
std::sort(sorted_images.begin(),
Expand All @@ -58,7 +58,7 @@ void format_images(Dest&& dest,

fmt::format_to(
dest,
"{:<28}{:<18}{:<17}{:<}\n",
"{:<18}{:<28}{:<17}{:<}\n",
mp::format::image_string_for(image.remote_name(), aliases[0]),
fmt::format("{}", fmt::join(aliases.cbegin() + 1, aliases.cend(), ",")),
image.version(),
Expand Down
8 changes: 4 additions & 4 deletions tests/unit/test_data/formatters/table/find_multiple_reply.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
Image Aliases Version Description
18.04 bionic,lts 20180421 Ubuntu 18.04 LTS
19.04 disco 20190516 Ubuntu 19.04
daily:19.10 eoan,devel 20190516 Ubuntu 19.10
Image Aliases Version Description
18.04 bionic,lts 20180421 Ubuntu 18.04 LTS
19.04 disco 20190516 Ubuntu 19.04
daily:19.10 eoan,devel 20190516 Ubuntu 19.10

2 changes: 1 addition & 1 deletion tests/unit/test_data/formatters/table/find_multiple_reply_duplicate_image.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Image Aliases Version Description
Image Aliases Version Description
snapcraft:core18 20190520 Snapcraft builder for core18
core:core18 20190520 Ubuntu Core 18

2 changes: 1 addition & 1 deletion tests/unit/test_data/formatters/table/find_one_reply.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
Image Aliases Version Description
Image Aliases Version Description
ubuntu 20190516 Ubuntu 18.04 LTS

2 changes: 1 addition & 1 deletion tests/unit/test_data/formatters/table/find_one_reply_no_os.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
Image Aliases Version Description
Image Aliases Version Description
snapcraft:core18 20190520 Snapcraft builder for core18

Loading