Skip to content

Perles

A terminal UI for beads issue tracking powered by a custom BQL (Beads Query Language). Search issues with boolean logic, filter by dates, traverse dependency trees, and build custom kanban views without leaving your terminal.

Search Mode

Kanban Board

Issue Children

Key Features

  • Kanban Board

    Organize issues into customizable columns powered by BQL queries or dependency trees. Create unlimited views with mixed column types.

    Kanban Mode

  • BQL Search

    Full-screen search interface powered by BQL (Beads Query Language) with boolean logic, date filters, and relationship traversal.

    Search Mode

  • Dependency Explorer

    Visualize and navigate issue relationships -- blockers, dependencies, and parent/child hierarchies as interactive trees.

    Dependency Explorer

  • BQL Query Language

    Purpose-built query language for filtering issues with operators, boolean logic, date ranges, sorting, and relationship expansion.

    BQL Reference

  • AI Orchestration

    Multi-agent control plane that coordinates headless AI agents for structured development workflows with parallel execution.

    Orchestration

  • Theming

    Comprehensive theme system with built-in presets (Catppuccin, Dracula, Nord) and fully customizable color tokens.

    Theming

Quick Start

Install

curl -sSL https://raw.githubusercontent.com/zjrosen/perles/main/install.sh | bash

Or via Homebrew (macOS/Linux):

brew tap zjrosen/perles
brew install perles

Run

cd your-project
perles

Requirements

  • A beads-enabled project (.beads/ directory)
  • Minimum beads database version v0.62.0 (run bd migrate to upgrade)
  • Go 1.21+ (if building from source)