Documentation

Introduction

A studio for your coding agents — what Atelier is, how the pieces fit together, and where to go next.

What is Atelier?

Atelier is a local-first Mac app for spinning up and controlling parallel AI coding agents — Claude Code first. Think of it as a studio: every agent gets its own isolated workspace, you watch them all work side by side, and you stay in control of what ships.

There is no cloud backend. Your repositories, worktrees, and agents all run on your Mac, and the app itself is a native Tauri shell — your OS webview, not a bundled Chromium.

refactor-auth
write-tests
zsh
localhost:3000
Add a logout button to the navbar

Auth lives in src/lib/auth.ts; the navbar renders the avatar in a right-aligned cluster — no logout affordance exists yet.

src/components/Navbar.tsx+4−1
return (
<nav className="navbar">
<Avatar user={user} />
+ <Avatar user={user} />
+ <button onClick={signOut}>Log out</button>

The button is in. One open question before I wire the handler:

Opus 4.8 · 48.2k tokens · $0.21 · 3.4s
Which auth provider should I use?
48k/200k
demo-app Tasks

Call the existing signOut() and redirect to / on success.

Files
Unstaged4
Navbar.tsxsrc/components/+41
session.tssrc/auth/+120
Avatar.tsxsrc/components/+20
auth.test.tssrc/+012

The pieces

  • The sidebar lists your workspaces — the folders you have opened — with their branches, worktrees, and the agents running on each. Status dots tell you who is working and who needs you. See Workspaces & sessions.
  • The center is a tab strip over one or more panes: agent transcripts, terminals, browser tabs, and file views, splittable side by side. See Tabs, terminal & browser.
  • The composer under each transcript is where you talk to an agent — with model, reasoning, and permission controls built in. See The composer.
  • The right panels hold your task board and the live view of every change an agent has made, through to commit and merge. See Tasks and Review & merge.
Requirements. macOS (Apple silicon or Intel), git, and a Claude account — Atelier uses your existing Claude Code sign-in, or asks for an Anthropic API key on first launch. The key is stored locally and everything runs on your machine.

Where to go next

Start with the Quick start — it takes you from install to your first merged agent branch in about five minutes. The Guides cover each part of the app in depth, and the Reference pages list every model, setting, and keyboard shortcut.

What's next for Atelier

Atelier is in preview, and the docs describe what ships today. Phone pairing, the plugin & skills marketplace, and support for more agents (Codex and friends) are on the way — see the roadmap for what lands when.