From 3cf4403ffa79fb0a831cacdc669cdea8c455e9f5 Mon Sep 17 00:00:00 2001
From: John Ogle <john@ogle.fyi>
Date: Fri, 9 Jan 2026 11:20:02 -0800
Subject: [PATCH] Add perles TUI package for Beads issue tracking
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds a custom Nix package for perles, a terminal user interface for the
Beads issue tracking system with BQL query language support.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 home/roles/development/default.nix |  1 +
 packages/default.nix               |  1 +
 packages/perles/default.nix        | 26 ++++++++++++++++++++++++++
 3 files changed, 28 insertions(+)
 create mode 100644 packages/perles/default.nix

diff --git a/home/roles/development/default.nix b/home/roles/development/default.nix
index 6af4239..f9b3a1c 100644
--- a/home/roles/development/default.nix
+++ b/home/roles/development/default.nix
@@ -44,6 +44,7 @@ in
 
       # Custom packages
       pkgs.custom.tea-rbw
+      pkgs.custom.perles
     ];
 
     # Install Claude Code humanlayer command and agent plugins
diff --git a/packages/default.nix b/packages/default.nix
index a2cfea3..2a07992 100644
--- a/packages/default.nix
+++ b/packages/default.nix
@@ -4,4 +4,5 @@
   tea-rbw = pkgs.callPackage ./tea-rbw {};
   app-launcher-server = pkgs.callPackage ./app-launcher-server {};
   claude-code = pkgs.callPackage ./claude-code {};
+  perles = pkgs.callPackage ./perles {};
 }
diff --git a/packages/perles/default.nix b/packages/perles/default.nix
new file mode 100644
index 0000000..cd0c771
--- /dev/null
+++ b/packages/perles/default.nix
@@ -0,0 +1,26 @@
+{ lib, buildGoModule, fetchFromGitHub }:
+
+buildGoModule rec {
+  pname = "perles";
+  version = "unstable-2025-01-09";
+
+  src = fetchFromGitHub {
+    owner = "zjrosen";
+    repo = "perles";
+    rev = "main";
+    hash = "sha256-JgRayb4+mJ1r0AtdnQfqAw2+QRte+licsfZOaRgYqcs=";
+  };
+
+  vendorHash = "sha256-R7UWTdBuPteneRqxrWK51nqLtZwDsqQoMAcohN4fyak=";
+
+  # Tests require a real git repository context
+  doCheck = false;
+
+  meta = with lib; {
+    description = "A TUI for the Beads issue tracking system with BQL query language";
+    homepage = "https://github.com/zjrosen/perles";
+    license = licenses.mit;
+    maintainers = [ ];
+    mainProgram = "perles";
+  };
+}