Anslut till en befintlig server

Det här är vägen när servern redan är uppsatt (t.ex. wss://rcai.brasse-pc.eu) och du känner din token. Du behöver bara webb-UI:t och en klient.

Vill du istället sätta upp allt själv? Se Hosta själv.

1. Webb-UI:t (mobil eller dator)

Öppna serverns adress i webbläsaren (t.ex. https://rcai.brasse-pc.eu) och logga in med din token.

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 utan hooks.
Godkännande-kort: om verktygsgodkännanden är på dyker agentens verktygsanrop upp som kort med Tillåt / Neka.

2. Installera klienten (Linux, x86_64 eller arm64)

Ett kommando — självständig binär, inga beroenden på målet:

curl -fsSL https://gitea.brasse-pc.eu/brasse/agent-helm/raw/branch/main/install.sh | sh

System-wide (/usr/local/bin): kör med | sudo sh.
Annars hamnar agent-helm i ~/.local/bin — ha den katalogen i din PATH.
Samma kommando på Arch, Ubuntu m.fl. Uppdatera senare: kör det igen.

3. Konfigurera och anslut

Fyll i ~/.config/agent-helm/config.env:

AGENT_HELM_TOKEN=<din token>
SERVER_URL=wss://rcai.brasse-pc.eu
AGENT_CMD=gemini
# AGENT_CWD=/sökväg/till/projekt

Starta klienten:

# som bakgrundstjänst (rekommenderas):
systemctl --user daemon-reload && systemctl --user enable --now agent-helm
# eller direkt:
set -a; . ~/.config/agent-helm/config.env; agent-helm

→ din session dyker upp i webb-UI:t. Öppna den på mobilen och styr agenten.

Var lagras din token?

Bara i ~/.config/agent-helm/config.env (rättigheter 600) på din maskin. Det är det enda som ger åtkomst till sessionerna — håll den hemlig. Tappar du den eller vill byta: be den som driftar servern om en ny token och uppdatera din config.env.

Verktygsgodkännanden (valfritt)

Vill du godkänna agentens verktygsanrop från mobilen? Lägg en BeforeTool-hook i ~/.gemini/settings.json på klientmaskinen:

{
  "hooks": {
    "BeforeTool": [
      { "hooks": [{ "type": "command", "command": "agent-helm hook" }] }
    ]
  }
}

Då visas varje verktygsanrop som ett kort i UI:t. Utan hook fungerar allt ändå.

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, `SERVER_URL=wss://…`, 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 (valfritt)

Tjänstens loggar: journalctl --user -u agent-helm -f.