i3-query

Query i3 tree using XPath-inspired path syntax.

AI-generated and unreviewed.

Installation

pipx install i3-query

Usage

Query the i3 window tree using dot-separated paths:

# Get the ID of the focused window
i3-query focused.id

# Get the ID of the parent container
i3-query focused.parent.id

# Get the ID of the grandparent container
i3-query focused.parent.parent.id

# Get the layout of the parent
i3-query focused.parent.layout

# Get the workspace name
i3-query focused.workspace.name

Inspiration

Inspired by XPath for navigating XML/HTML documents. Uses an object style dot syntax because you want to understand xpath.

Use Cases

• Debugging container hierarchies
• Finding container IDs for use with i3-msg commands