User guideWayseer 0.28.3Contents

Commands

Every command runs from the palette: press Ctrl+K (⌘K on macOS), type > and the command's ID, then a space, and Tab completes its parameters, written as name=value. The keys are the defaults; the config's keymap section changes them (config). A command with a model tool is one the language model may run, by that name (language model).

The app

app.quit

Quit

Keys: Ctrl+Q
macOS: ⌘Q

app.frame-times

Toggle frame times

Keys: F3
macOS: F3

app.hints

Toggle key hints

Keys: F1
macOS: F1

app.tour

Show the tour of the keys

Keys: Shift+F1
macOS: ⇧F1

config.reload

Reload config now, as saving the file does

Windows

window.new

Open a window showing what this one shows

Keys: Ctrl+Shift+N
macOS: ⇧⌘N

window.close

Close this window; closing the last quits

Keys: Ctrl+Shift+W
macOS: ⇧⌘W
⌘W

window.follow

Follow the focus of the window last used, or stop

Palette

palette.open

Find entities, commands and places

Keys: Ctrl+K
macOS: ⌘K

Language model

ask.new

Start a new conversation with the model

nl.explain

Explain the focus, selection or view with the model

nl.ask

Ask the model a question; Enter on an empty one explains

Keys: ?
macOS: ?

nl.panel

Show or hide the model's narration

Keys: Ctrl+J
macOS: ⌘J

nl.log

Show the last requests sent to the model

What changed

observations.show

Show or hide what changed out of view

Keys: w
macOS: w

Actions

actions.log

Show the last actions proposed and how they ended

action.offer

List the actions allowed on the focus

Keys: a
macOS: a

action.run

Propose an action on an entity, or the focus, to confirm

Parameters: action= (required) the action's ID, such as restart. ref= an entity's ref, as the context or search_entities gives it. params= its parameters, such as replicas=3,for=1h. For example replicas=3.

View

view.pan-left

Pan left

Keys: h, Left, H (far=true), Shift+Left (far=true)
macOS: h, ←, H (far=true), ⇧← (far=true)

Parameters: far= true for a longer step. One of true, false.

view.pan-right

Pan right

Keys: l, Right, L (far=true), Shift+Right (far=true)
macOS: l, →, L (far=true), ⇧→ (far=true)

Parameters: far= true for a longer step. One of true, false.

view.pan-up

Pan up

Keys: k, Up, K (far=true), Shift+Up (far=true)
macOS: k, ↑, K (far=true), ⇧↑ (far=true)

Parameters: far= true for a longer step. One of true, false.

view.pan-down

Pan down

Keys: j, Down, J (far=true), Shift+Down (far=true)
macOS: j, ↓, J (far=true), ⇧↓ (far=true)

Parameters: far= true for a longer step. One of true, false.

view.zoom-in

Zoom in

Keys: +
=
macOS: +
=

view.zoom-out

Zoom out

Keys: -
macOS: -

view.home

Go to the home bookmark, or frame everything

Keys: 0
macOS: 0

view.focus

Focus an entity

Parameters: ref= (required) an entity's ref, as the context or search_entities gives it.

Model tool: focus

view.open

Open the focused entity

Keys: Enter
macOS: Return

Parameters: ref= an entity's ref, as the context or search_entities gives it.

Model tool: open

view.unfocus

Close Detail, or clear the focus, the selection or the filter

Keys: Esc
macOS: Esc

focus.clear

Clear the focus

selection.clear

Clear the selection

view.merge

Show entities that are the same as one, or apart

Filter

filter.edit

Filter what every lens shows

Keys: /
macOS: /

filter.clear

Clear the filter

filter.set

Filter what every lens shows

Parameters: text= a filter in the palette's syntax; without it, everything. For example status:warn,crit, kind:service, team=storefront, cores>=16, name~payments, #prod.

Model tool: set_filter

Back and forward

nav.back

Go back

Keys: Backspace
macOS: Delete

nav.forward

Go forward

Keys: Shift+Backspace
macOS: ⇧Delete

Time

time.back

Scrub back in time

Keys: [, { (far=true), Ctrl+T Left, Ctrl+T Shift+Left (far=true)
macOS: [, { (far=true), ⌘T ←, ⌘T ⇧← (far=true)

Parameters: far= true for a longer step. One of true, false.

time.forward

Scrub forward in time

Keys: ], } (far=true), Ctrl+T Right, Ctrl+T Shift+Right (far=true)
macOS: ], } (far=true), ⌘T →, ⌘T ⇧→ (far=true)

Parameters: far= true for a longer step. One of true, false.

time.zoom-in

Show a shorter time span

Keys: Ctrl+T Up
macOS: ⌘T ↑

time.zoom-out

Show a longer time span

Keys: Ctrl+T Down
macOS: ⌘T ↓

time.live

Follow the clock

Keys: Ctrl+T n
macOS: ⌘T n

time.last

Show a span ending now, live, or ending at a time

Keys: Ctrl+T 1 (span=15m), Ctrl+T 2 (span=1h), Ctrl+T 3 (span=6h), Ctrl+T 4 (span=1d), Ctrl+T 5 (span=7d)
macOS: ⌘T 1 (span=15m), ⌘T 2 (span=1h), ⌘T 3 (span=6h), ⌘T 4 (span=1d), ⌘T 5 (span=7d)

Parameters: span= (required) how far back, such as 15m, 6h or 7d. For example 15m, 1h, 6h, 1d, 7d. until= when the span ends, in RFC 3339; without it, now and following the clock. For example 2026-09-26T03:00:00Z.

Model tool: set_time_window

Lenses

lens.show

Show a lens

Parameters: lens= (required) the lens to bring to the front; detail needs a focus. One of topology, timeline, grid, stream, detail, treemap, flow, geo.

Model tool: set_lens

lens.topology

Show Topology

Keys: 1
macOS: 1

lens.timeline

Show Timeline

Keys: 2
macOS: 2

lens.grid

Show Grid

Keys: 3
macOS: 3

lens.stream

Show Stream

Keys: 4
macOS: 4

lens.detail

Open the focused entity in Detail

Keys: 5
macOS: 5

lens.treemap

Show Treemap

Keys: 6
macOS: 6

lens.flow

Show Flow

Keys: 7
macOS: 7

lens.geo

Show Geo, the map

Keys: 8
macOS: 8

Grid

grid.next

Show the next metric in Grid, measure in Treemap, or unit in Flow

Keys: m
macOS: m

grid.previous

Show the previous metric in Grid, measure in Treemap, or unit in Flow

Keys: M
macOS: M

grid.show

Show a metric in Grid

Parameters: metric= (required) a catalog metric, such as cpu.utilisation. kind= the kind of entity, if the metric has several.

Model tool: show_metric

grid.sort

Sort Grid hottest first or by name

Keys: o
macOS: o

Parameters: by= value or name; without it, the other order. One of value, name.

Flow

flow.show

Show Flow narrowed to an entity's traffic

Parameters: ref= (required) an entity's ref, as the context or search_entities gives it.

Model tool: show_flow

Geo

geo.show

Show Geo at a place, or following an entity

Parameters: ref= an entity's ref, as the context or search_entities gives it. place= a place config names, or a point as lat, lon, instead of ref.

Model tool: show_map

Treemap

treemap.show

Show Treemap, sized by a measure, of one kind of entity

Parameters: by= what sizes the tiles: an attribute or metric that adds up, such as bytes or requests per second. kind= show only entities of this kind; without it, the filter stays. One of alert, cluster, container, database, disk, host, interface, node, person, pod, process, queue, repo, service, table, team.

Model tool: show_treemap

Stream

stream.severity

Show events of a severity and above in Stream

Keys: s
macOS: s

Parameters: level= the least severity shown; without it, the next up. One of debug, info, warn, error, critical.

stream.scope

Show events near the focus, or all, in Stream

Keys: n
macOS: n

Parameters: near= true for the focus and its neighbors, false for all; without it, the other. One of true, false.

stream.top

Scroll Stream to the newest event

Keys: t
macOS: t

Bookmarks

place.save

Bookmark this place

Parameters: name= (required) one word to find it by. For example work, incident.

Model tool: bookmark

place.go

Go to a bookmark

Parameters: name= (required) a bookmark.

Model tool: go_to_bookmark

place.rename

Rename a bookmark

Parameters: name= (required) a bookmark. to= (required) its new name. For example work, incident.

place.delete

Delete a bookmark

Parameters: name= (required) a bookmark.

place.export

Export bookmarks to a file to share

Parameters: file= (required) a file, from your home folder or starting ~/ or /. For example ~/bookmarks.yaml. names= the bookmarks to export, separated by commas; without it, all of them.

place.import

Import bookmarks from a file

Parameters: file= (required) a file, from your home folder or starting ~/ or /. For example ~/bookmarks.yaml. replace= true takes the imported bookmark where a name is already used, instead of adding it as name-2. One of true, false.

Compare

compare.selected

Compare the two selected entities, or the focus with the one selected

Keys: c
macOS: c

compare.entities

Compare two entities side by side

Parameters: a= (required) the entity on the left, by ref, as the context or search_entities gives it. b= (required) the entity on the right, by ref.

Model tool: compare

compare.before

Compare the focus with the window just before, or with the same window earlier

Keys: C
macOS: C

Parameters: ago= how much earlier, such as 1d for yesterday or 7d for last week; without it, the window just before. For example 1d, 7d.

Model tool: compare_with_earlier

compare.swap

Swap Compare's sides

Keys: x
macOS: x

Sources

source.list

Show or hide the sources, to turn them on and off

Keys: S
macOS: S

source.on

Turn a source on

Parameters: name= (required) the name of a module instance in config.

Model tool: turn_source_on

source.off

Turn a source off; its entities leave the view until it is on again

Parameters: name= (required) the name of a module instance in config.

Model tool: turn_source_off

License

license.show

Show or hide the license: who it is for, and the modules it unlocks

license.terms

Show or hide the Wayseer end-user license this release is under

license.add

Add a license key, from the clipboard or as typed

Parameters: key= the key as it was sent to you; without it, the key copied is added. For example WAYSEER-1.….

license.remove

Remove the license key that license.add stored

updates

updates.show

Show or hide what is newer than this release, and whether your key covers it

updates.install

Download the newer Wayseer, check its signature, and install it on Y

updates.undo

Undo the last update, bringing back the release it replaced

modules

modules.install

Install a signed module package

Parameters: file= (required) a module package, .wsmod.tar.gz or .wsmod.zip. For example ~/Downloads/acme-widget-1.4.0-linux-amd64.wsmod.tar.gz.

modules.update

Download a newer marketplace module, show what it changes, and install it on Y

Parameters: id= (required) an installed marketplace module, such as acme/gauge. For example acme/gauge.

modules.revocations.add

Add a signed revocation list

Parameters: file= (required) a revocation list signed by Wayseer. For example ~/Downloads/index.