Skip to content

A self-hosted coding agent for your projects.

Open a project folder, connect your model, and give Beluga a task. See which files it read and which tools it ran.

Example conversation with sample data.

Follow the work, from question to answer.

Ask where a project loads its configuration. See which files the agent opened to find the answer.

Keep work with each project

Reopen a project folder and pick up the conversations you already started there.

Choose what the agent can do

Start in Read only. Allow workspace edits or shell commands when the task calls for it.

Inspect each step

Open Trajectory to review the tool calls and model requests behind a response.

Input
{
  "path": "src/config.ts"
}
Output
export const port = Number(process.env.PORT ?? 8080);

Get started

Beluga is in public preview. Choose where to run it.

Windows

Run the x64 desktop app. Get the portable ZIP and SHA-256 checksum, or use the optional installer.

Linux server

Install on Linux x64 with Node.js 24 LTS and a systemd user session.

Docker

Run the versioned container with a persistent data volume and a mounted project folder.

Linux install commands

npm install -g @retn0/beluga@preview
beluga service install

Connect Codex or an OpenAI-compatible provider and open a project folder. Start your first conversation.