Grid

Build your company with a team of agents.

One self-hosted workspace for your people, your AI coding agents and your code. The board, the threads, the files and the terminal, on the machine that holds the project, from any device.

Beta · Any AI provider · Runs on a laptop, a VPS or a Codespace · MIT or Apache-2.0

Website · Watch the intro · Install · What works today · Docs

curl -fsSL https://grid.rabtx.dev/install.sh | bash

Linux or macOS, with git. Adds Grid on port 8080 and prints a link that creates your account. To add another machine to a Grid you already run: … | bash -s -- runner. See Install.

---

Why Grid

A task, its code, the agent working on it and the terminal running it usually live in four different places. Grid puts them around the project folder, so the context is already there:

1. Plan. Tasks live on the project's board, for people and agents alike.
2. Ask. Start a thread in the project and say what you want built.
3. Watch it work. The agent runs in the real folder. Every command, edit, diff and test streams into the thread, and it asks before doing anything you haven't allowed.
4. Carry on anywhere. Close the laptop and pick the thread up on your phone. The work kept going on the machine with the code.

Agents are workers in the project, not a chat box next to it. Grid is not tied to one AI provider, one machine or one deployment platform: the execution machine is disposable, while projects, threads and context persist.

See it

Screens from an example workspace, "Kestrel", a fictional field-service startup. The agent threads shown are real runs.

What works today

Area	What you can do
Workspaces	A workspace is the company: it owns projects and environments, and people join by invite. Self-hosted setup starts from a one-time link.
Projects and board	Link project folders, then plan tasks from backlog to done, owned by people or agents, with notes per project.
Agent threads	Talk to Claude Code, Codex, opencode and Antigravity, or any agent that speaks ACP. Replies, tool calls, diffs and approvals stream live, and threads resume after a restart. Pick the model, effort and mode per thread.
Composer	@ to mention files, / for commands, attach images and files, dictate by voice, and choose the branch or a fresh worktree from the git control under the box.
Files and terminals	Browse the project, edit files in the browser with conflict-safe saves, and use persistent terminals on the project's machine.
Git and pull requests	Worktrees per thread when you want them; a project's pull requests with checks and reviews, and "fix with an agent" to hand a failing PR to an agent on its own branch.
Inbox and notifications	One inbox for approvals, finished and failed runs, review requests and failing checks, with push notifications to your devices.
Environments	Run projects on this machine, on a paired Grid instance, or in a GitHub Codespace managed from Grid.
Phone and offline	The console installs as an app; recent screens open instantly and the shell reopens offline. Live agent and terminal work needs the runner.

Grid is a working development workspace today, not yet the full startup operating system in its mission: deployment, operations and business management are later product areas. The project reference explains the architecture and where data lives.

Install

On Linux or macOS, with git:

curl -fsSL https://grid.rabtx.dev/install.sh | bash

It installs Bun if it is missing, puts Grid in ~/.grid, starts it on port 8080 as a user service (systemd or launchd) and prints a one-time link that creates your account and workspace; after that, people join by invite. A grid command manages it: grid status, grid logs, grid update, grid uninstall.

Grid keeps its data in an embedded database by default. To keep it beyond this machine, threads included, point it at a hosted Postgres and use grid restore on the next machine:

curl -fsSL https://grid.rabtx.dev/install.sh | GRID_DATABASE_URL='postgres://…' bash

To add another machine (a VPS, a Codespace, a second laptop) to a Grid you already run, install only the runner there. It listens on your Tailscale network and prints an address and a pairing code to add in Settings → Environments:

curl -fsSL https://grid.rabtx.dev/install.sh | bash -s -- runner

The script is scripts/bash/install.sh.

From a checkout

You need Bun 1.4.2.

git clone https://github.com/Rabtx/grid.git
cd grid
bun install
bun run grid

The launcher prints the same one-time setup link (also saved in .grid/setup-link.txt). bun run grid uses an embedded database under .grid/ when DATABASE_URL is unset, applies migrations, builds the console, and runs the API and runner behind one port.

Install at least one agent CLI on the machine (Grid can help from Settings → Agents). For a Codespace or VPS, environment variables, pairing and deployment, read the portable Grid guide. To work on individual services, see development commands.

How it works

 browser / phone ──▶ console (Solid 2 PWA)
                          │
                ┌─────────┴──────────┐
                ▼                    ▼
        API (Hono on Bun)     runner (Bun) ── agent CLIs · terminals · files · git
        people, projects,          │
        tasks, notes               └──▶ paired Grid environments and Codespaces
        (PostgreSQL)

• Console: the product interface, a Vite + Solid 2 app that installs as a PWA.
• API: identity, workspaces, projects, tasks and notes, on Hono with PostgreSQL.
• Runner: lives on the machine with the code. It drives agent CLIs, keeps threads in SQLite, and serves terminals, files and git to the console. Other machines join as paired environments.

One bun run grid runs all three behind a single port, so a whole Grid is one disposable bundle.

What's next

• Automations: agent jobs that run on a schedule or when a pull request opens or a check fails.
• Agent commands: each agent's own slash commands in the composer's / menu.
• A cleaner composer: one + for files, photos, project files, mentions and commands, with upload progress and previews.

The open board tracks what's being built; the plans describe broader directions. These are directions, not release dates.

Repository map

Path	Role
apps/console	Solid 2 product interface and installable PWA
apps/runner	Bun service for agents, chat sessions, terminals, project files, and environments
apps/launcher	bun run grid: setup and one-port gateway
apps/api	The Grid API (Hono on Bun) for identity, projects, tasks, notes, and billing
apps/web	Next.js landing page; the Solid console is the product
apps/docs	Setup, API, architecture, and deployment guides
packages/	Shared tokens, UI, logging, and TypeScript configuration
.agents/	Project board, plans, ownership, and agent work rules

Grid uses Bun workspaces. See PROJECT.md for development commands and technical boundaries, DESIGN.md for the interface language, and AGENTS.md before contributing code. Documentation source lives in apps/docs/content/docs/.

License

Choose either MIT or Apache-2.0.

The file icons in apps/console/public/file-icons/ are the paid Flow Icons pack by thang-nm, used with the author's permission. They are not covered by either license; see that folder's README.