#i3 #workspace #i3ipc

app i3-insert-workspace

Tool for flexible creation of named workspaces in the i3 window manager

4 stable releases

1.3.2 Mar 31, 2023
1.3.1 Mar 30, 2023
1.0.1 Mar 11, 2022
1.0.0 Mar 10, 2022

#53 in Configuration

MIT license

715 lines


crates.io MIT licensed

Insert a new named workspace between two other named workspaces.

Makes use of the i3 IPC protocol.


i3-insert-workspace [OPTIONS]

  -p, --pivot <PIVOT>
          Workspace before or after which the new workspace is inserted.

          If no pivot given, using focused workspaces

  -b, --before
          Insert before the pivot instead of after it

  -n, --name <NAME>
          Name of the new workspace

  -m, --mode <MODE>
          Method to insert workspace is handled differently for i3 and sway

          [default: i3]
          [possible values: i3, sway]

  -c, --container-id <CONTAINER_ID>
          Move container to the new workspace.

          Either provide container id, or `focused` for focused one

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version


From the commandline

i3-insert-workspace --pivot "After me" --container-id focused --name "New workspace"

In i3 config file

set $insert_workspace ~/.config/i3/i3-insert-workspace
bindsym $mod+Control+w exec --no-startup-id $insert_workspace --before
bindsym $mod+Control+v exec --no-startup-id $insert_workspace
bindsym $mod+Control+Shift+W exec --no-startup-id $insert_workspace --before --container-id focused
bindsym $mod+Control+Shift+V exec --no-startup-id $insert_workspace --container-id focused


~61K SLoC