From dce376f2b71550e127e72be69272d66d886fa84d Mon Sep 17 00:00:00 2001
From: Nicolas Cantu <nicolas.cantu@pm.me>
Date: Mon, 23 Mar 2026 21:24:31 +0100
Subject: [PATCH] repos-devtools-server: gitignore .env, systemd unit template,
 README run modes
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

**Motivations:**
- Document user systemd and keep secrets out of git

**Root causes:**
- N/A

**Correctifs:**
- N/A

**Evolutions:**
- .env gitignored; systemd/user template and README

**Pages affectées:**
- services/repos-devtools-server/.gitignore
- services/repos-devtools-server/README.md
- services/repos-devtools-server/systemd/user/*
---
 services/repos-devtools-server/.gitignore         |  1 +
 services/repos-devtools-server/README.md          | 15 +++++++++++++--
 .../repos-devtools-server/systemd/user/README.md  |  8 ++++++++
 .../systemd/user/repos-devtools-server.service    | 14 ++++++++++++++
 4 files changed, 36 insertions(+), 2 deletions(-)
 create mode 100644 services/repos-devtools-server/systemd/user/README.md
 create mode 100644 services/repos-devtools-server/systemd/user/repos-devtools-server.service

diff --git a/services/repos-devtools-server/.gitignore b/services/repos-devtools-server/.gitignore
index b947077..deed335 100644
--- a/services/repos-devtools-server/.gitignore
+++ b/services/repos-devtools-server/.gitignore
@@ -1,2 +1,3 @@
 node_modules/
 dist/
+.env
diff --git a/services/repos-devtools-server/README.md b/services/repos-devtools-server/README.md
index 49827c8..5502cf9 100644
--- a/services/repos-devtools-server/README.md
+++ b/services/repos-devtools-server/README.md
@@ -21,12 +21,23 @@ All endpoints require `Authorization: Bearer <REPOS_DEVTOOLS_TOKEN>`.
 
 ## Run
 
+### One-off (foreground)
+
 ```bash
 cd services/repos-devtools-server
 npm install
 npm run build
-export REPOS_DEVTOOLS_TOKEN='generate-a-long-random-secret'
-npm start
+# Create .env (gitignored) with REPOS_DEVTOOLS_TOKEN=... and REPOS_DEVTOOLS_ROOT=/home/ncantu/code
+set -a && source .env && set +a && node dist/server.js
+```
+
+### systemd (user)
+
+Copy `systemd/user/repos-devtools-server.service` to `~/.config/systemd/user/`, create `.env` beside this README, then:
+
+```bash
+systemctl --user daemon-reload
+systemctl --user enable --now repos-devtools-server.service
 ```
 
 Use the same token in the VS Code / Cursor setting **`anythingllm.reposApiToken`**.
diff --git a/services/repos-devtools-server/systemd/user/README.md b/services/repos-devtools-server/systemd/user/README.md
new file mode 100644
index 0000000..5d49f3d
--- /dev/null
+++ b/services/repos-devtools-server/systemd/user/README.md
@@ -0,0 +1,8 @@
+# User systemd unit
+
+1. Create `../.env` (see main README): `REPOS_DEVTOOLS_TOKEN`, `REPOS_DEVTOOLS_ROOT`.
+2. `mkdir -p ~/.config/systemd/user`
+3. `cp repos-devtools-server.service ~/.config/systemd/user/`
+4. `systemctl --user daemon-reload && systemctl --user enable --now repos-devtools-server.service`
+
+Adjust `WorkingDirectory`, `EnvironmentFile`, and `ExecStart` paths if the repository is not at `/home/ncantu/code/smart_ide`.
diff --git a/services/repos-devtools-server/systemd/user/repos-devtools-server.service b/services/repos-devtools-server/systemd/user/repos-devtools-server.service
new file mode 100644
index 0000000..92b9239
--- /dev/null
+++ b/services/repos-devtools-server/systemd/user/repos-devtools-server.service
@@ -0,0 +1,14 @@
+[Unit]
+Description=4NK repos-devtools-server (git API for /home/ncantu/code)
+After=network.target
+
+[Service]
+Type=simple
+WorkingDirectory=/home/ncantu/code/smart_ide/services/repos-devtools-server
+EnvironmentFile=/home/ncantu/code/smart_ide/services/repos-devtools-server/.env
+ExecStart=/usr/bin/node dist/server.js
+Restart=on-failure
+RestartSec=3
+
+[Install]
+WantedBy=default.target