selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Grix logo

Self-host Grix

v3.2.15+3067

Cross-platform messaging for AI agent collaboration

ReleaseSource AvailableOther
Updated6 hours ago
LanguageGo
Setup difficultyModerate
MobileNative app
ThemeDark mode
Stars
155
Requires
Go, Node.js
Install with Linux

What is Grix?

Grix is a cross-platform chat and teamwork tool built for interacting with AI coding agents as though they were human coworkers. It gives you a single messaging screen where you can add agents as buddies, talk to them one-on-one or in groups, tag them to hand out tasks, and watch their progress live. The stack bundles a Go backend that speaks WebSockets, Flutter front-ends for seven platforms including mobile, desktop, and browser (as a PWA), an admin console, and a Python voice bridge for real-time calls. Agents execute locally on your computer through grix-connector (Node.js) or attach remotely via the WebSocket protocol. You can kick off a job on your desktop, approve a step on your watch, and pick it up later on your phone — every message, file, execution trace, and approval stays in one continuous thread. The code uses a custom source-available license that permits only non-commercial use; commercial deployment requires a separate agreement. You can deploy it through the desktop app (which handles grix-connector automatically), by installing grix-connector directly on a headless box, or with the supplied Kubernetes manifests.

Should you self-host Grix?

Grix scores 44/100 on selfhost.directory (how scoring works) and ranks #71 of 110 in Chat. It has 155 GitHub stars.

It shipped 4 stable releases in the past year. The latest, v3.2.15+3067, came out on 28 October 2026. New versions land roughly every 2 days.

Setup is moderate: expect some configuration beyond a single command. It is Other-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is Zulip (82/100, 26 127 stars). It scores higher overall, so compare the two before you pick. See Grix vs Zulip side by side.

Features

  • Administration app
  • Agent Client Protocol (ACP) support
  • Agent permission scopes
  • AI agent contacts
  • Cross-platform messaging
  • External agent WebSocket protocol
  • Group collaboration with agents
  • Human-in-the-loop control
  • Markdown Rendering
  • @mention agents
  • Multi-device Sync
  • Voice calls with agents

Grix README

How to install Grix

Install Grix with Linux

Linux

| Linux | Grix-Linux-x64.tar.gz — extract and run

Auto-installs and manages grix-connector

How to configure Grix

  • agent_idAgent ID from Grix platform

    Agent ID from Grix platform

  • api_keyAPI key for authentication

    API key for authentication

  • client_typeType of agent to connect (claude, codex, copilot, qwen, codewhale, cursor, opencode, pi, deepseek, reasonix)

    Type of agent to connect (claude, codex, copilot, qwen, codewhale, cursor, opencode, pi, deepseek, reasonix)

    values: claude, codex, copilot, qwen, codewhale, cursor, opencode, pi, deepseek, reasonix

  • pool.idleTimeoutMs300000Idle adapter eviction timeout in milliseconds

    Idle adapter eviction timeout in milliseconds

  • pool.maxSize20Max adapter pool size

    Max adapter pool size

  • prompt_timeout_msPrompt execution timeout in milliseconds

    Prompt execution timeout in milliseconds

  • ws_urlWebSocket endpoint URL for grix-connector

    WebSocket endpoint URL for grix-connector

    values: wss://grix.dhf.pub/v1/agent-api/ws

Grix releases & version history

FAQ

Can I control access and collaboration?

Yes, agent conversations and progress remain visible to the owner, while access scopes, role context, responsibilities, and permissions can be isolated and authorized.

Can I take over while an agent is working?

Yes, you can add instructions, pause work, change responsibilities, reassign it, or take direct control at any time.

Which agents can I use?

Grix currently supports 15 agents including DeepSeek Harness, Claude, Codex, Kimi, Qwen, Cursor, Copilot, and OpenCode, plus a general ACP bridge.

Which platforms are supported?

Grix is available on iOS, Android, Windows, macOS, Linux, and the Web.

What is Grix?

Grix is a mobile and desktop collaboration app for DeepSeek Harness and other coding agents that lets you talk to agents and work with them like colleagues.

More in Collaboration

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…