feat(usage): add more common commands to usage/windows and usage/workspaces

This commit is contained in:
LGUG2Z committed 2026-01-20 18:40:45 -08:00
1 parent c9b69d0ffc
commit 991db15ef8
2 files changed
+77 -2

No files matched your search

+38 -1
View File
@@ -34,7 +34,7 @@ The window at the largest tile can be focused using the <PlatformLink command="p
It is possible to attempt to focus the first window on any workspace matching an executable name using the <PlatformLink command="eager-focus" /> command.
## Movement
## Movement on a Workspace
Windows can be moved in the following ways.
@@ -49,3 +49,40 @@ Windows can be moved in a cyclic direction using the <PlatformLink command="cycl
### Largest Tile
Windows can be moved to the largest tile using the <PlatformLink command="promote-swap" /> command. This command is reversible.
## Movement Across Workspaces
The commands covering movement of windows across workspaces in komorebi come in two flavors:
- `move` - these commands move the focused window to a target workspace and then focus the target workspace
- `send` - these commands move the focused window to a target workspace while remaining on the currently focused workspace
### By Workspace Index
The focused window can be moved or sent to a workspace on the focused monitor identified by an index using the <PlatformLink command="move-to-workspace"/> and <PlatformLink command="send-to-workspace"/> commands respectively.
### Cycle Direction
The focused window can be moved or sent to a workspace on the focused monitor in a cyclic direction using the <PlatformLink command="cycle-move-to-workspace"/> and <PlatformLink command="cycle-send-to-workspace"/> commands respectively.
### By Monitor and Workspace Index
The focused window can be moved or sent to a workspace on a specific monitor identified by monitor and workspace indicies using the <PlatformLink command="move-to-monitor-workspace"/> and <PlatformLink command="send-to-monitor-workspace"/> commands respectively.
### By Name
The focused window can be moved or sent to a workspace in a monitor-agnostic manner by name using the <PlatformLink command="move-to-named-workspace"/> and <PlatformLink command="send-to-named-workspace"/> commands respectively.
### By Last Workspace
The focused window can be moved or sent to a last focused workspace on the focused monitor using the <PlatformLink command="move-to-last-workspace"/> and <PlatformLink command="send-to-last-workspace"/> commands respectively.
## Movement Across Monitors
### By Monitor Index
The focused window can be moved or sent the focused workspace at a monitor identified by index using the <PlatformLink command="move-to-monitor"/> and <PlatformLink command="send-to-monitor"/> commands respectively.
### Cycle Direction
The focused window can be moved or sent to the focused workspace of a monitor in a cyclic direction using the <PlatformLink command="cycle-move-to-monitor"/> and <PlatformLink command="cycle-send-to-monitor"/> commands respectively.
+39 -1
View File
@@ -3,4 +3,42 @@ title: Workspaces
description: Configuring workspaces
---
TODO
import PlatformLink from '../../../components/PlatformLink.astro';
import { Tabs, TabItem, Steps } from '@astrojs/starlight/components';
<Tabs syncKey="platform">
<TabItem label="Windows">
</TabItem>
<TabItem label="macOS">
</TabItem>
</Tabs>
## Focus
Workspaces can be focused in the following ways.
### By Index
Workspaces can be focused by index on the focused monitor using the <PlatformLink command="focus-workspace"/> command, or by a mixture of monitor index and workspace index using the <PlatformLink command="focus-monitor-workspace"/> command.
### By Name
Workspaces can be focused in a monitor-agnostic manner by name using the <PlatformLink command="focus-named-workspace"/> command. All of your workspaces should have unique names. If two workspaces have the same name, the first match in the window manager state will be focused.
### By Last Workspace
The last focused workspace on the focused monitor can be focused using the <PlatformLink command="focus-last-workspace"/> command.
### Across Multiple Monitors
Workspaces can be focused by index across all monitors using the <PlatformLink command="focus-workspaces"/> command. This will focus the same workspace index on all monitors simultaneously, giving the feeling of a workspaces which span all monitors.
## Movement
Workspaces can be moved to other monitors in the following ways.
### By Focus and Index
The focused workspace can be moved to a monitor identified by an index using the <PlatformLink command="move-workspace-to-monitor"/> command.