LiveAgent

🌟 Special Thanks

❤️ Sponsor

Why LiveAgent?

LiveAgent is a local-first AI agent desktop client. It deeply integrates large language model reasoning with local system tools, so the AI can genuinely operate your file system, run commands, and manage scheduled tasks — while the Gateway enables remote access and collaboration.

• An agent that actually gets things done — beyond chat: read and write files, make precise edits, run Bash, and supervise long-running processes
• A fully open ecosystem — bridge any external tool via the MCP protocol, and load Skills packages on demand
• Local and remote, both — the desktop app works fully standalone; deploy the Gateway and control it from any browser

Core Features

🧠 Multi-Model & Chat

• Multi-model routing — Claude (Anthropic), Codex (OpenAI), and Gemini protocols, with custom Base URL support for third-party compatible services
• Rich rendering — streaming Markdown with built-in KaTeX math, Mermaid diagrams, and Monaco code preview
• History compaction — dual-layer Segment + Summary Checkpoint persistence keeps long conversations from losing context
• Internationalization — built-in i18n multi-language framework

🔧 Local Tool Execution

• Full file-system capabilities — precise Read / Write / Edit / Delete, plus Glob / Grep pattern and regex search
• Bash & long-running processes — non-interactive command execution (cwd / timeout), with ManagedProcess supervising dev servers and other resident tasks
• Sub-agent delegation — independent sub-agents execute in parallel with worktree isolation and automatic merging
• Tunnel exposure — TunnelManager exposes local services to the public internet in one click

🧩 MCP & Skills Ecosystem

• MCP protocol bridging — the Tauri side natively bridges any stdio / http MCP server for unlimited tool extension
• Skills packages — progressive disclosure and on-demand loading, with install / create / package support and the ClawHub ecosystem

💾 Memory & Automation

• Persistent memory — Markdown + SQLite FTS full-text search for cross-session knowledge management
• Scheduled tasks — bash / http / prompt cron job types, executed automatically in the background

🌐 Remote Gateway

• Access from any browser — Go + gRPC gateway with a WebUI for remotely controlling the local agent
• Disconnect recovery — a bounded seq window replays short outages, with desktop-side persistence as the safety net

Download & Deployment

Installers are automatically built, signed, and published by GitHub Actions — grab the latest version from GitHub Releases.

System Requirements

macOS

Download the DMG matching your chip from Releases, open it, and drag LiveAgent into Applications:

• Apple Silicon (M-series): LiveAgent-<version>-macOS-aarch64.dmg
• Intel: LiveAgent-<version>-macOS-x64.dmg

The installer is signed and notarized by Apple — no manual security override is needed on first launch.

Windows

Pick an installation method from Releases:

Linux

Choose by distribution from Releases:

Need Remote Access? Deploy the Gateway

The desktop app works out of the box and depends on no server. Deploy the Gateway only if you want to control your local agent from a browser.

Note: when deployed behind an Nginx reverse proxy, set the Gateway address on the Settings → Remote page to the HTTPS URL and use port 443.

# Pull the image (built by GitHub Actions, multi-arch: amd64 / arm64)
docker pull ghcr.io/stack-cairn/liveagent-gateway:latest

# Run in the background (gRPC → host 50051 | HTTP/WebSocket → host 50052)
docker run -d \
  --name liveagent-gateway \
  --restart unless-stopped \
  -p 50051:50051 \
  -p 50052:8080 \
  -e LIVEAGENT_GATEWAY_TOKEN=your-token \
  ghcr.io/stack-cairn/liveagent-gateway:latest

The Gateway serves two kinds of traffic:

the desktop app's bidirectional gRPC stream (default 50051) and the browser's HTTP / WebSocket (default 50052).

When exposing through Nginx, proxy them separately. Both gRPC and WebSocket are long-lived connections, so raise the timeouts:

# GUI Remote: gRPC Authenticate + AgentConnect
location /liveagent.gateway.v1.AgentGateway/ {
    grpc_pass grpc://127.0.0.1:50051;

    grpc_set_header Host $host;
    grpc_set_header Authorization $http_authorization;
    grpc_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    grpc_set_header X-Forwarded-Proto $scheme;

    grpc_socket_keepalive on;
    grpc_read_timeout 24h;
    grpc_send_timeout 24h;
}

# WebUI WebSocket
location = /ws {
    proxy_pass http://127.0.0.1:50052;

    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";

    proxy_set_header Host $host;
    proxy_set_header Authorization $http_authorization;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;

    proxy_read_timeout 24h;
    proxy_send_timeout 24h;
    proxy_buffering off;
}

# WebUI SPA/static/API
location / {
    proxy_pass http://127.0.0.1:50052;

    proxy_set_header Host $host;
    proxy_set_header Authorization $http_authorization;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;

    proxy_read_timeout 10m;
    proxy_send_timeout 10m;
}

Upstream ports map one-to-one to the host ports from the docker run above: gRPC 50051, HTTP/WebSocket 50052 (inside the container, HTTP actually listens on PORT=8080). The gRPC proxy requires Nginx to accept the desktop connection over HTTP/2 (listen 443 ssl; http2 on;).

Build from Source

Expand the Development Guide below for the full set of Make commands.

┌──────────────────────────────────────────────────────────────┐
│                        Browser WebUI                          │
│