# Följappar

## Vad är följappar?

Följappar är inbyggda applikationer för iOS, Android och macOS som ansluter till din Gateway som **noder**. Noder exponerar enhetsfunktioner, kamera, canvas, skärminspelning, plats, röst och systemexekvering, för dina agenter.

Tänk på det så här: Gateway är hjärnan och följappar är händerna och ögonen på dina enheter.

## Hur noder fungerar

1. **Anslut**, Följappen ansluter till din Gateway via WebSocket
2. **Para**, Nya enheter genomgår en parkopplingsgodkännandeprocess
3. **Registrera kapaciteter**, Appen berättar för Gateway vad den kan göra (kamera, canvas, plats, osv.)
4. **Agenter anropar**, Under konversationer kan agenter be noden ta ett foto, spela in skärm, rendera en canvas och mer

Noder är **inte gateways**, de kör inte sin egen AI. De är kringutrustningsenheter som utökar vad dina agenter kan göra.

## macOS-följapp

macOS-appen lever i din menyrad och fungerar som både en följnod och en gateway-hanterare.

### Kapaciteter
- **Canvas**, Rendera interaktivt webbinnehåll i ett inbyggt fönster
- **Kamera**, Ta foton och videoklipp (framsida/baksida)
- **Skärminspelning**, Helskärm eller per-app-inspelning
- **Systemexekvering**, Kör skalkommandon på Mac:en (begränsat av exekveringsgodkännanden)
- **Notiser**, Skicka inbyggda macOS-notiser med prioritetsalternativ
- **Plats**, GPS när tillgängligt

### Ytterligare funktioner
- **Gateway-hantering**, Starta, stoppa och övervaka Gateway
- **Behörighetshantering**, Hanterar macOS TCC-behörigheter (Notiser, Tillgänglighet, Skärminspelning, Mikrofon, Taligenkänning, AppleScript)
- **Djuplänkar**, `neotask://` URL-schema för att starta agenter med parametrar
- **CLI-installation**, Installerar kommandoradsverktyget `neotask`

## iOS-app

iOS-appen ansluter som en nod till din Gateway och tillför mobila kapaciteter till dina agenter.

### Kapaciteter
- **Canvas**, SwiftUI-baserad interaktiv innehållsrendering
- **Kamera**, Foton och videoklipp (fram- och bakkameror)
- **Ljudinspelning**, Mikrofonfångst
- **Plats**, GPS med noggrannhetsval
- **Notiser**, Inbyggda iOS push-notiser

### Funktioner
- **Upptäckt**, Hittar din Gateway via Bonjour (LAN), Tailscale (VPN) eller manuell inmatning
- **Parkoppling**, Säker enhetsparkoppling med godkännande från Gateway
- **Röstvakningsord**, Vakningsords-aktivering för handsfree-interaktion
- **Talläge**, Kontinuerlig röstkonversation
- **Delningsfunktion**, Dela innehåll från andra appar direkt till din agent
- **A2UI**, Agentstyrd UI-rendering på enhetens canvas

### Begränsningar
- Förgrundsfokuserad design (iOS pausar WebSocket-anslutningar i bakgrunden)
- Strikta bakgrundskommandobegränsningar
- För närvarande i intern förhandsvisning

## Android-app

Android-appen ansluter som en nod med kapaciteter liknande iOS.

### Kapaciteter
- **Canvas**, Jetpack Compose-baserad UI-rendering
- **Kamera**, Foton och video (fram och bak, behörighetsbegränsat)
- **Skärminspelning**, Systemskärminspelning (Android 10+)
- **Plats**, GPS med noggrannhetslägen
- **SMS-sändning**, På enheter med telefonistöd
- **Chatt och historik**, Visa konversationshistorik på enheten

### Funktioner
- **Förgrundstjänst**, Beständig notis håller anslutningen vid liv
- **Delade sessioner**, Samma session på alla anslutna noder
- **Modern Android**, Kräver Android 12+ (API 31)

## Headless-nodvärd

Kör en nod utan något användargränssnitt, idealisk för byggservrar, fjärrmaskiner eller headless Linux-servrar.

### Kapaciteter
- **Systemexekvering**, Kör kommandon på nodvärden
- **Kommandotillåtningslista**, Konfigurera vilka kommandon noden kan köra
- **Beständig tjänst**, Installera som launchd/systemd-tjänst

### Användningsfall
- CI/CD-byggagenter, Låt din AI-agent utlösa byggen på en fjärrserver
- Hemlab-automatisering, Kör kommandon på en Raspberry Pi eller hemserver
- Flermaskinorkestrering, Koordinera uppgifter på flera maskiner

## Enhetsparkoppling

### Parkopplingsflöde
1. Följappen presenterar sin enhetsidentitet (fingeravtryck + offentlig nyckel)
2. Gateway utfärdar en parkopplingsgodkännandebegäran
3. Du godkänner enheten via skrivbordsappen eller instrumentpanelen
4. Gateway utfärdar en enhetstoken för framtida anslutningar

### Förtroendemodell
- **Lokala enheter** (loopback) godkänns automatiskt för bekvämlighet
- **Icke-lokala enheter** kräver uttryckligt godkännande
- Enhetstokens lagras lokalt och återanvänds vid återanslutning

## Exekveringsgodkännanden

För noder som kan köra systemkommandon (macOS, headless-värdar) kontrollerar exekveringsgodkännanden vad som är tillåtet:

- **Tillåtningsliste-läge**, Endast förgodkända kommandon kan köras
- **Frågeläge**, Okända kommandon uppmanar dig att godkänna
- **Fullständigt läge**, Inga begränsningar (använd med försiktighet)

Konfigurera per-nod-tillåtningslistor för att exakt kontrollera vad varje enhet kan göra.