sway-keybindings

Configures Sway keybindings using bindsym, bindcode, modes, and window management commands.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/milojarow/dotfiles --skill sway-keybindings
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sway-keybindings
Source: https://github.com/milojarow/dotfiles/tree/main/.claude/skills/sway-keybindings
Command: npx skills add https://github.com/milojarow/dotfiles --skill sway-keybindings

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps users efficiently configure and utilize keyboard shortcuts, manage window layouts, and navigate workspaces within the Sway window manager, reducing reliance on mouse input and improving workflow speed.

Core Features & Use Cases

  • Keybinding Configuration: Define and manage custom keyboard shortcuts using bindsym and bindcode.
  • Binding Modes: Create layered keybinding sets for complex workflows (e.g., resize mode, system mode).
  • Window Management: Control window focus, movement, resizing, floating, and tiling layouts.
  • Workspace Navigation: Switch between, move windows to, and assign workspaces to outputs.
  • Use Case: Quickly reconfigure your Sway keybindings to use Vim-like navigation for window focus and movement, and set up a dedicated mode for launching applications.

Quick Start

Configure Sway keybindings to focus windows using h, j, k, l keys.

Frequently Asked Questions about sway-keybindings

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Sway window manager keybindings for Vim-like navigation?

Sway keybindings can be configured using bindsym and bindcode syntax to map modifier keys with h, j, k, l for window focus and movement. This allows replacing mouse input with keyboard-driven tiling window control.

What are binding modes in Sway and when should I use them?

Binding modes in Sway are layered keybinding sets that allow grouping shortcuts for complex workflows. They are useful for creating dedicated environments like resize, system, or launcher modes to prevent keybinding conflicts.

Can I target specific windows for layout changes in a tiling wm?

Yes, Sway supports window management commands with criteria to target specific windows. You can control layout options like splith, splitv, stacking, and tabbed, alongside focus and movement operations.

How do I manage multi-monitor workspaces and assign windows to outputs in Sway?

Sway workspace management includes switching, naming, and assigning windows to specific workspaces or outputs. This enables multi-monitor configurations by binding workspaces directly to designated screens.

Does the --to-code flag affect how bindsym works in Sway?

The --to-code flag in Sway bindsym configuration translates keysyms into physical keycodes. This ensures keybindings remain consistent across different keyboard layouts by binding to hardware locations.