Meridian

Give AI agents a safe environment to write and run code, manage files, and execute tasks — with a chat UI, API, and CLI to interact with them.

How it works

The chat UI opens a persistent SSE connection and sends messages to the API, which runs a LangGraph agent. The agent runs commands in a Docker sandbox (file ops, background processes, arbitrary code) and pushes events back through the SSE stream. The CLI adds external capabilities, authenticated via OAuth device flow.

Request lifecycle

Getting started

Prerequisites

• Node.js 24+ (see .nvmrc)
• pnpm 9.15.2+
• Docker (for the sandbox and OAuth server)

Setup

git clone <repo-url> && cd meridian
pnpm install
pnpm setup          # generate .env files

Running

pnpm --filter @meridian/api run build:sandbox
docker compose up    # starts OAuth server (port 8080)
pnpm dev             # starts API (port 3201) + Chat (port 3200)