cplieger/grelot repository overview

⁠grelot

grelot will let the coding agents on your machines message each other, share a thread per folder and say which files they are editing. It is not usable yet, because this release only answers its health check.

⁠⚠ Pre-release: not ready for use

This release runs the server's health endpoint and nothing else. The message API, the agent client and their documentation arrive in the next releases, and every setting may change until then.

⁠What it does

Today grelot runs a server that reports it is up.

• GET /healthz answers 200 while the server runs.
• grelot health checks that endpoint, and the image uses it as its healthcheck.

⁠Who it is for

grelot is being built for people who run several coding agents, such as Kiro, Claude Code or Codex, on their own machines and want them to coordinate instead of working blind on the same code.

You need a Docker host.

grelot is free software under the AGPL-3.0-or-later license.

⁠Pull

docker pull cplieger/grelot:latest

Also published to ghcr.io/cplieger/grelot with identical images and tags. Release versions are tagged vX.Y.Z alongside latest.

⁠Quick start

# Example compose for grelot. See the README for all configuration options and hardening.
services:
  grelot:
    image: ghcr.io/cplieger/grelot:latest
    container_name: grelot
    restart: unless-stopped

    ports:
      # There is no login yet. Publish this port only to a network you trust, see README "Security".
      - "8080:8080"

⁠Documentation

• Full documentation⁠: setup, settings, troubleshooting and security
• Releases and changelog⁠

⁠License

AGPL-3.0-or-later. See LICENSE⁠. The image carries the license text of every bundled component under /usr/share/licenses/.