Användar-guide: setup, klient, var nycklar lagras, anslutning

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Home.md

@@ -0,0 +1,109 @@
+# agent-helm
+
+Kör dina CLI-agenter (Gemini) på valfri maskin och **styr dem från mobil eller webb** —
+live-terminal, fallback-tangentbord och (valfritt) godkännande-kort för verktygsanrop.
+
+> Den här sidan är skriven ur användarens perspektiv: hur du sätter upp det, kör
+> klienten, var nycklar lagras och hur du ansluter.
+
+---
+
+## Snabbstart (3 steg)
+
+1. **Öppna webb-UI:t:** [`https://rcai.brasse-pc.eu`](https://rcai.brasse-pc.eu) och logga in med din token.
+2. **Installera klienten** på maskinen där agenten ska köra (se nedan).
+3. **Sätt token + starta klienten** → sessionen dyker upp i UI:t, redo att styras.
+
+---
+
+## 1. Webb-UI:t (mobil eller dator)
+
+- Adress: `https://rcai.brasse-pc.eu`
+- Logga in med din **token** (samma som klienterna använder).
+- Till vänster: alla anslutna sessioner. Välj en → du ser dess terminal live.
+- **Fallback-tangentbord** längst ned: `← ↑ ↓ →`, `Enter`, `Esc`, `Tab`, `Ctrl-C`, `y`/`n`.
+  Det funkar alltid — även om inga hooks är uppsatta.
+- **Godkännande-kort:** om verktygsgodkännanden är på (se längre ned) dyker
+  agentens verktygsanrop upp som kort med **Tillåt / Neka**.
+
+## 2. Installera klienten (Linux, x86_64 eller arm64)
+
+Ett kommando — laddar ner rätt binär (Node + allt inbäddat, inga beroenden):
+
+```bash
+curl -fsSL https://gitea.brasse-pc.eu/brasse/agent-helm/raw/branch/main/install.sh | sh
+```
+
+- System-wide (i `/usr/local/bin`): kör med `| sudo sh` istället.
+- Annars hamnar den i `~/.local/bin` — se till att den katalogen ligger i din `PATH`.
+- Fungerar lika på Arch, Ubuntu m.fl. — binären är självständig.
+
+Uppdatera senare: kör samma kommando igen. För en specifik version:
+`AGENT_HELM_VERSION=v0.1.1 curl ... | sh`.
+
+## 3. Konfigurera och anslut
+
+Installern skapar `~/.config/agent-helm/config.env`. Fyll i:
+
+```ini
+AGENT_HELM_TOKEN=<din hemliga token>
+SERVER_URL=wss://rcai.brasse-pc.eu
+AGENT_CMD=gemini
+# AGENT_CWD=/sökväg/till/projekt
+```
+
+Starta klienten:
+
+```bash
+# som bakgrundstjänst (rekommenderas):
+systemctl --user daemon-reload && systemctl --user enable --now agent-helm
+
+# eller direkt i terminalen:
+set -a; . ~/.config/agent-helm/config.env; agent-helm
+```
+
+Klienten ansluter till servern och **din session dyker upp i webb-UI:t**. Öppna den
+på mobilen och styr agenten.
+
+---
+
+## Var lagras nycklar och hemligheter?
+
+- **Token** (det enda som skyddar åtkomsten till dina sessioner) lagras:
+  - på **klienten** i `~/.config/agent-helm/config.env` (filrättigheter `600`),
+  - på **servern** i dess konfiguration (på Pi5).
+- Den finns **aldrig** i git-repot eller någon publik fil.
+- Samma token måste användas av både webb-UI:t och klienterna för att de ska få ansluta.
+- **Håll token hemlig.** Vill du byta/rotera den: uppdatera den på servern och i varje
+  klients `config.env`, och starta om.
+
+## Verktygsgodkännanden (valfritt)
+
+Vill du godkänna agentens verktygsanrop från mobilen? Lägg till en `BeforeTool`-hook i
+`~/.gemini/settings.json` på klientmaskinen:
+
+```json
+{
+  "hooks": {
+    "BeforeTool": [
+      { "hooks": [{ "type": "command", "command": "agent-helm hook" }] }
+    ]
+  }
+}
+```
+
+Då visas varje verktygsanrop som ett kort i UI:t (Tillåt/Neka). Utan hook fungerar allt
+som vanligt — agenten kör på, och du styr via terminalen/fallback-tangentbordet.
+
+---
+
+## Felsökning
+
+| Problem | Trolig orsak |
+|---|---|
+| UI:t laddar men inga sessioner | Ingen klient ansluten, fel token, eller fel `SERVER_URL` |
+| Klienten ansluter inte | Kontrollera token, att `SERVER_URL=wss://rcai.brasse-pc.eu`, och nätet |
+| `agent-helm: command not found` | Lägg `~/.local/bin` i din `PATH` (eller installera system-wide) |
+| Inga godkännande-kort | Hooken är inte uppsatt i `~/.gemini/settings.json` (valfritt) |
+
+Loggar för tjänsten: `journalctl --user -u agent-helm -f`.