Metadata-Version: 2.4
Name: i3-query
Version: 0.1.0
Summary: Query i3 tree using XPath-inspired path syntax
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: i3ipc

# i3-query

Query i3 tree using XPath-inspired path syntax.

AI-generated and unreviewed.

## Installation

```bash
pipx install i3-query
```

## Usage

Query the i3 window tree using dot-separated paths:

```bash
# 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
