Skip To Content

Start

Get Started

Install Alera and run your first CLI coding agent in its own workspace.

On This Page

Alera is a native workbench for CLI coding agents. You run Claude Code, Codex, Amp, Antigravity, OpenCode, Cursor, Copilot, Pi, Grok Build, fx, or any other terminal agent in a real PTY, each in its own Git worktree when the project is Git-backed.

It is not another AI IDE and it does not wrap a single chat backend. The desktop app is Flutter, and the runtime that owns your terminals is a Rust sidecar that keeps running when you close the window. There is no Electron and no bundled Chromium.

Download Alera See Install Options

First Session#

  1. Install Alera for your platform, then open the app.
  2. Register a project: an existing local folder, or a Git clone from a URL. Its first workspace opens on the project folder.
  3. Open a terminal tab and launch an agent CLI the same way you would in any shell.
  4. For the next task, save an agent profile for your CLI and press Mod+Shift+N for New Workspace (Mod is ⌘ on macOS and Ctrl on Windows and Linux). Describe the task, pick the profile, and, in a Git project, choose New Worktree so the task gets its own branch and folder. AI Assist names the workspace, and the agent starts with your prompt.

That is the whole loop. Everything else in these docs is how to keep several of those loops running at once without collisions.

Find Your Way Around#

New Workspace

Start a task from a prompt or by hand, on the project folder or in its own worktree.

Terminals And Panes

Tabs, splits, the composer, and sessions that outlive the window.

CLI Agents

First-class integrations, status hooks, and the rule that any CLI still runs.

Source Control

Stage, commit, and sync, read diffs, and send line comments to an agent.

Pull Requests And Checks

Create and merge pull requests, follow checks, and let an agent watch and fix them.

Orchestration

Runs a coordinator plans and your agent profiles carry out, followed and decided in Activity.

Remote Hosts

Run workspaces on machines you reach over SSH, with the desktop as the hub.

Mobile Companion

Pair an Android phone and answer an agent from anywhere.

The sidebar lists every page, and Search Docs (Ctrl K, or ⌘K on macOS) finds the rest.

What These Docs Cover#

These pages are for people using Alera: install, the workbench, agents, review, coordination, remote hosts, and the companion app. They describe behavior that ships today.

Contributor internals (architecture, CI, design-system rules, release signing) stay in the GitHub repository, not here.

Edit This PageUpdated

Type to search every page.