Tags and hiding

Tags are short labels on workspaces, like parked or spike. Use them, and each PR's state, to search the dashboard and to hide workspaces you're not working on.

Tagging workspaces

Press # on a workspace, or Ctrl-x # while attached to one, to open the tag editor:

Typing filters the list, which offers every tag used in wsx. Changes save as you make them.

Attached to a workspace on a shared host, Ctrl-x # edits its tags on that host. The editor offers the tags used by that host's listed workspaces. Each change shows at once and runs wsx workspace tag there over ssh, one at a time in the order you made them; they finish even if you close the editor or detach. If a change fails, the editor shows the host's actual tags and why it failed.

To tag a workspace as you create it, press ↓ in the new-workspace form and type its tags, separated by spaces or commas. An invalid tag keeps the form open and says which one. Creating a workspace with the cursor on a hidden tag group, or on a workspace inside one, fills in that group's tag; edit the field to change it.

Tag rules:

• Lowercase a-z, 0-9, -, and _, starting with a letter or digit.
• Up to 32 characters.

From a shell or an agent:

wsx workspace tag add parked
wsx workspace tag rm parked --workspace backend/old-spike
wsx workspace tag list --all

See wsx workspace tag for the full syntax.

Tags show dimmed after the branch name: ⎇ wsx/my-slug #parked #ui. They use only the space left in the branch column, and tags that don't fit collapse to a count like +2. To make room, widen the column with the dashboard_branch_width setting. Attached to a workspace, local or remote, its tags show after its name in the top bar; when the bar is too narrow they drop as a group rather than folding to a count.

Workspace tags are unrelated to prompt tags.

Hiding workspaces

Press F on a repo header, or any row in the repo, to choose what that repo hides. Move with j/k and toggle with space. wsx saves the choice per repo.

Hidden workspaces collapse into one dimmed row per rule:

▸ ⏺ merged  ·  4 hidden
▸ #parked  ·  2 hidden

Press enter or l on that row to show its workspaces, and h to collapse it. An expanded group and its workspaces show at full brightness. Expanded rows stay open until wsx restarts.

By PR state

The states are no PR, draft, open, conflicted, merged, and closed. Each hides every matching workspace, except no PR, which keeps a workspace visible when any of these is true:

• It has commits ahead of its base branch, or uncommitted changes.
• An agent session is running, or its agent reports working, waiting, or blocked.
• It was created, or its agent was active, in the last 3 days.

A workspace whose PR state hasn't loaded yet stays visible.

By tag

The F picker lists every tag in use above the PR states. A tag rule hides every workspace with that tag, even one with work in progress. A workspace matching a tag rule and a PR rule is grouped under the tag. A rule for a tag no longer in use stays in the picker with a count of 0, so you can turn it off.

What still counts hidden workspaces

• A / search covers every workspace, hidden or not.
• Status bar, Waybar, and menu bar counts include hidden workspaces.
• The updates panel (Ctrl-x u) shows the same group rows as the dashboard. Expanding a group in either place expands it in both.
• The attached view's top bar leaves them out, except workspaces carrying a tag listed in the top_bar_show_tags setting. Those stay in the bar unless a PR rule hides them.
• The by-attention view (G) lists them in a HIDDEN section.

If the selected workspace becomes hidden, for example when its PR merges, the selection moves to its group's row.

Searching

Press / and type. The filter matches branch names, repo names, tags, status words, and recaps, ignoring case. Prefix a tag with # to match only that exact tag:

/parked      anything containing "parked"
/#parked     tagged exactly "parked"

esc clears the filter.

To narrow the list by status, click a status in the header tally. See Filtering by status.