From c72705994ab45d5b68554fe91a85c9c896c0fc07 Mon Sep 17 00:00:00 2001
From: Yuval Adam <_@yuv.al>
Date: Fri, 24 Jul 2026 12:25:54 +0200
Subject: Add local uv development service installer

---
 README.md           | 15 +++++++++++++++
 scripts/install-dev | 22 ++++++++++++++++++++++
 2 files changed, 37 insertions(+)
 create mode 100755 scripts/install-dev

diff --git a/README.md b/README.md
index 09db7cd..6f494b3 100644
--- a/README.md
+++ b/README.md
@@ -79,6 +79,21 @@ uv run parleyctl cancel
 uv run parleyctl copy
 ```
 
+For the normal development loop, install an editable local user service once:
+
+```bash
+./scripts/install-dev
+```
+
+This writes only to `~/.config/systemd/user` and `~/.local/share/dbus-1/services`; it does not install a system package. Python source changes are visible through the editable uv install. Restart the daemon after changes and follow its journal with:
+
+```bash
+systemctl --user restart parley.service
+journalctl --user -u parley.service -f
+```
+
+Rerun `./scripts/install-dev` after changing entry points or service files.
+
 ## Arch Linux package
 
 The local PKGBUILD installs `parleyd` and the other executables under `/usr/bin`, the systemd **user** unit under `/usr/lib/systemd/user`, and the session D-Bus service under `/usr/share/dbus-1/services`. It builds from the latest committed state of this checkout:
diff --git a/scripts/install-dev b/scripts/install-dev
new file mode 100755
index 0000000..3602a0a
--- /dev/null
+++ b/scripts/install-dev
@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)
+unit_dir=${XDG_CONFIG_HOME:-$HOME/.config}/systemd/user
+dbus_dir=${XDG_DATA_HOME:-$HOME/.local/share}/dbus-1/services
+
+cd "$root"
+uv venv --python /usr/bin/python --system-site-packages --clear
+uv pip install --editable .
+
+mkdir -p "$unit_dir" "$dbus_dir"
+sed "s|^ExecStart=.*|ExecStart=$root/.venv/bin/parleyd|" \
+  data/systemd/parley.service > "$unit_dir/parley.service"
+install -m644 data/dbus/org.parley.Transcription1.service \
+  "$dbus_dir/org.parley.Transcription1.service"
+
+systemctl --user daemon-reload
+systemctl --user enable --now parley.service
+
+echo "Installed local development service from $root"
+echo "Run: uv run parleyctl status"
-- 
cgit v1.3.1