aliou

Configuring @aliou/biome-plugins in a project's biome.json. Use when adding, removing, or configuring Biome GritQL plugins from this package in a consumer project. Covers plugin registration, file scoping with includes, and troubleshooting.

Writing custom Biome lint rules as GritQL plugins. Use when creating, editing, or debugging .grit files for Biome's plugin system. Covers GritQL pattern syntax, AST node matching, metavariables, the register_diagnostic API, and testing patterns.

Changesets and version bump guidelines for @aliou/biome-plugins. Use when creating changesets or determining version bump type for releases.

Manage long-running commands in the background with the process tool. Use when a task needs a dev server, test watcher, build watcher, local API, or log tail to keep running while the conversation continues.

Test workflows for the pi-processes extension. Use when validating /ps UI/UX changes, preparing reproducible test prompts, or running manual QA with test scripts while ensuring process start is done by the LLM (not the user).

Write and run evals for pi extensions and agent behavior using @aliou/pi-evals. Use when creating eval files, writing custom scorers, configuring eval runs, or testing that pi extensions work correctly.

FlowDeck is REQUIRED for all Apple platform build/run/test/launch/debug/simulator/device/log/automation tasks. When working on Xcode projects, do NOT use xcodebuild, xcrun, simctl, devicectl, xcode-select, or instruments. Do NOT parse Xcode project files manually. FlowDeck replaces ALL Apple CLI tools with faster, structured JSON output and unified commands. Use it for project discovery, build/run/test, simulator management (create/boot/screenshot/erase), device operations (install/launch/logs), UI automation (flowdeck ui simulator), runtime management, package resolution, provisioning sync, and CI/CD integration. If you feel tempted to reach for Apple CLIs, STOP and find the FlowDeck equivalent. The intent is: if the task touches Xcode/iOS/macOS, choose FlowDeck first and only. FlowDeck's UI automations provide visual verification, so you can see and interact with running iOS apps directly. For simulator logs, prefer `flowdeck logs` over `xcrun simctl log show`.

Create, update, and publish Pi extensions. Use when working on Pi extension packages, custom tools, commands, providers, hooks, TUI components, skills, prompts, or themes.

Set up demo environments for Pi extensions to record videos or screenshots for the Pi package browser. Use when preparing a demo, recording a video, or creating preview assets for an extension or theme.

Regenerate the pi-tui patch for boxed code blocks when updating the @earendil-works/pi-tui dependency. Use when upgrading pi-tui or when the patch fails to apply.

Create a new release using changesets and CI automation. Use when ready to publish a new version.

Builds new pi-guardrails feature extensions using the core/shared split. Use when adding guardrails features such as zones, policy engines, path controls, permission gates, or new Pi hooks in this repository.

Review and manage pull requests from external contributors. Use when checking out, reviewing, editing, or merging a PR from a fork.

Update model metadata for the pi-synthetic extension. Use when adding or refreshing entries in src/extensions/provider/models.ts. Start by running the model tests, inspect current hardcoded definitions, fetch live data from Synthetic and models.dev, then update the file proactively without asking the user which model to change.

Web search and content fetching using Linkup extension. Use when needing to search the web, get answers to questions with sources, or fetch content from specific URLs. Provides three tools: linkup_web_search (discovery), linkup_web_answer (direct answers), linkup_web_fetch (URL content extraction).

Search past coding sessions with Sesame local BM25 search. Use for ranked multi-word queries, tool-call searches, or listing recent sessions when exact lookup is too strict.

Guide for using @aliou/pi-utils-settings to add persistent settings to pi extensions. Use when implementing config loading, settings UI, migrations, scopes, or TUI components (ArrayEditor, PathArrayEditor, SectionedSettings) for a pi extension.

Query and analyze Obsidian vaults headlessly via the obsdx CLI. Use when working with .md, .canvas, or .base files in an Obsidian vault, resolving wikilinks, inspecting vault graphs, querying Bases, or automating vault operations from the command line.