the signals and their derived score are provisional and subject to change.
validate manually before sharing.
fdfa170eee55af03e21d3626901ad7f45c3a8197none
# CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
## Project Overview
Piri is a Rust binary extending the [Niri](https://github.com/YaLTeR/niri) Wayland compositor via IPC. It runs as a daemon that listens for Niri events and exposes CLI subcommands over a Unix socket. Plugins are the primary extension mechanism — each implements the `Plugin` trait and registers in `src/plugins/mod.rs`.
## Build & Run
```bash
# Build (debug)
cargo build# AGENTS.md
## Overview
Rust binary extending the Niri compositor. Requires Rust toolchain.
## Build & Install
- Debug: `cargo build`, Release: `cargo build --release`
- Recommended install: `./install.sh` (builds release, installs to `~/.local/bin/piri` or `/usr/local/bin/piri`, copies config to `~/.config/niri/piri.toml`)
- Manual install: `cargo install --path .` (user) / `sudo cargo install --path . --root /usr/local` (system)
## Formatting & Linting
- Format: `cargo fmt` (config `rustfmt.toml`: 100 none