A local-first desktop workspace for user-installed Codex and Claude Code.
Run many agents across projects and worktrees, side by side with their diffs, terminals, and browser.
Install · Features · Docs · Latest release
xd doesn't ship a model or an agent. It wraps the CLIs, logins, and configuration you already have in one persistent workspace. A single daemon owns every session, and you can reach it from another computer or your Android phone. Closing xd stops the daemon it started, along with its work; run the daemon yourself to keep work going while the app is closed.
- Native chat for Codex and Claude Code: streamed replies, activity cards for tool calls and shell runs, queued messages, and inline approvals and questions showing the command or diff they would apply.
- Live subagent cards show each delegated agent's model, current step, tools, tokens, and elapsed time, and keep its report once it finishes. Stop a Claude agent or send it to the background from its card.
- Background work stays visible. A chat whose agent still has background agents or shells running shows as waiting on them, with each task's latest output.
- Attachments both ways. Attach files with the paperclip, by dropping them, or by pasting an image. Images an agent names in a reply appear in the chat.
- Project → session → chat tabs. A session works in the project's checkout or a checkout you pick, or in a new Git worktree on its own branch. Choose a new worktree to keep agents from editing the same files. A session's chat tabs share its workspace.
- Side pane and terminal next to every chat: an integrated browser, files, and changes on the side, a shell below, all resizable and remembered per chat.
- Agents use the browser too. On Linux, Claude and Codex can open pages in their chat's browser, read them, click, type, and take screenshots while you watch.
- Pull requests in place. Projects, worktrees, and branches live in one sidebar, and a chat can link up to 32 pull requests: its branch's PR, ones opened from xd or by the agent, and any you add from the session header.
- Settle finished sessions with one click. Idle and merged sessions settle by themselves.
- One daemon owns local and remote sessions; clients come and go.
- Direct remote connections over pinned TLS, with expiring pairing codes and revocable devices. No relay, no SSH.
- An Android app with the same projects, chats, approvals, terminal, and usage.
- Usage and limits (Ctrl+U): cost and tokens by provider, model, and day, plus your Codex and Claude subscription limits across accounts.
- Uses your own tools. xd discovers your installed CLIs and reuses their authentication and configuration. Glassy dark and light themes included.
![]() |
![]() |
| Subscription limits by account (Ctrl+U) | A chat on Android |
Linux (x86_64)
curl -fsSL https://github.com/RestartFU/xd/releases/latest/download/install.sh | sh -s -- --releasemacOS
curl -fsSL https://github.com/RestartFU/xd/releases/latest/download/install-macos.sh | sh -s -- --releaseWindows (x86_64): download xd-windows-x86_64.msi from the
latest release and run it. xd
opens when the installer finishes, and is in the Start menu from then on.
None of the installers needs root or administrator access. Nightly desktop builds are on the nightly release, along with the Android APK when signing credentials are configured.
Windows notes
The window and browser run natively; local projects, agents and persistent sessions run in your default WSL distribution, where xd runs its own matching Linux host.
- Install WSL and a Linux distribution:
wsl --installin PowerShell, then finish the distribution's first-time setup. See Microsoft's guide. - Inside the distribution, install git, tmux, an SSH client and CA certificates.
On Ubuntu or Debian:
sudo apt update && sudo apt install git tmux openssh-client ca-certificates. - Install Codex, Claude Code or GitHub Copilot CLI inside the same distribution,
on its
PATH.
Projects and files use Linux paths, such as /home/you/project. Browser localhost
addresses are Windows's own; WSL 2 forwards servers running inside it. Set
XD_WSL_DISTRIBUTION to use a distribution other than the default.
The installer needs no administrator rights: it installs for your account under
%LOCALAPPDATA%\Programs\xd. Run a newer installer to update, and remove xd from
Windows Settings like any other app; your chats and settings are kept apart from
the program and survive both. The nightly build installs as a separate app, xd
Nightly, with its own settings.
The browser pane uses Microsoft's WebView2 Runtime, which Windows 11 includes. If it is missing, the pane says so and links to Microsoft's installer.
If xd closes unexpectedly it says so, and saves a report to
%LOCALAPPDATA%\xd\crash.log.
- Install your assistants. Install and sign in to Codex and/or Claude Code on
the machine running the xd host, and keep their commands on
PATH. Agent binaries and credentials are not included in xd. - Add a project. Press
+beside Projects in the sidebar and choose a folder or repository. - Start a session in it and send a message. Open more chat tabs, the side pane, or the terminal as you go.
- Pair another device (optional): open Settings → Devices → Pair a device on the host and copy the code. On the remote desktop or Android app, enter an address that reaches the host (LAN, Tailscale, or server; port 4001 by default) and paste the code. See remote connections.
Installed Linux and macOS builds update themselves: an Update button appears when a new xd, Codex, or Claude Code release is out, and nothing installs until you confirm.
| Guide | What it covers |
|---|---|
| Sessions and layout | Side pane and terminal, settling, auto-settle, and auto-delete |
| The host | Assistant discovery, updates, resuming cut-off turns, memory limits |
| Remote connections | Pairing devices, switching hosts, shared sessions, device management |
| Mobile development | The Android client and how it talks to the daemon |
| Protocol | The client–daemon wire protocol |
./scripts/build.sh
./scripts/test.shWindows builds use scripts/build-windows.ps1, which packages the app as an MSI with
WiX 3 around a matching static Linux host from scripts/build-windows-host.sh. The
windows GitHub Actions workflow builds both parts, installs the MSI, drives the
installed window with real pointer input (scripts/test-windows-ui.ps1), and checks
a real Windows-to-WSL connection. scripts/build-windows-icon.sh regenerates the
Windows icon from the app's vector artwork.
The CLI discovery and update behavior adapt portions of
T3 Code for xd's Rust backend. Its MIT
notice is included in data/licenses/t3code-LICENSE and packaged builds.


