Skip to content

Latest commit

 

History

History
48 lines (32 loc) · 1.09 KB

File metadata and controls

48 lines (32 loc) · 1.09 KB

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.

kanban board

bql search

Documentation

Full documentation is available at zjrosen.github.io/perles.

Quick Start

Install Script

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

Homebrew (macOS/Linux)

# Install via Homebrew
brew tap zjrosen/perles
brew install perles

Usage

Run perles in any directory containing a .beads/ folder:

cd your-project
perles

Requirements

  • A beads or beads-rust enabled project containing a .beads/ directory
  • Minimum beads database version v0.62.0 (run bd migrate to upgrade)

License

MIT