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.

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

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

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

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

cd your-project
perles

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

MIT