Perceo
Get Archductor
Perceo
Read docs
← All products

Coding agents

Available

Archductor

Desktop control plane for coding agents.

Create a workspace, start Codex or Claude Code, review the diff, open or merge a GitHub pull request, archive the workspace, then start the next task without leaving the app.

Read the docsView on GitHub

Coding agents

Archductor

Synced
Workspaces

docs-refresh

branch + worktree + port

pricing-copy

branch + worktree + port

setup-flow

branch + worktree + port

PTY agents

$ archductor session start docs-refresh

loading project brief...

workspace ready, checks attached

Diff

+128 / -34

2 comments staged

PR flow

checks clear

archive after merge

Linux is the primary validated target. Homebrew installs the headless CLI and archcar daemon; APT, DNF, and AppImage are the Linux desktop paths. Windows is a preview target. Inspired by Conductor.

What it does

  • Give each workspace its own Git worktree, branch, .context directory, and stable ARCHDUCTOR_PORT range.
  • Run multiple workspaces for the same repository in parallel without them trampling each other.
  • Start multiple Shell, Codex, or Claude Code sessions inside one workspace.
  • Review changed files, diffs, todos, comments, PR checks, and sibling workspace conflicts in one surface.
  • Create, refresh, merge, and archive GitHub PRs through your own local gh auth.

The loop

  1. 1Add an existing repository or clone a Git URL.
  2. 2Configure scripts, prompts, and workspace defaults in .archductor/settings.toml.
  3. 3Create a workspace from a branch, prompt, GitHub issue, GitHub PR, or Linear issue.
  4. 4Start Codex, Claude Code, or shell sessions inside it.
  5. 5Review the diff, checks, todos, comments, and conflicts.
  6. 6Create or merge the PR, archive the workspace, then repeat.

Install

Homebrew / Linuxbrew (CLI)
brew tap perceo-ai/tap
brew install archductor
archductor doctor
APT (Debian / Ubuntu)
curl -fsSLo /tmp/archductor-archive-keyring.gpg \
  https://www.perceo.ai/apt/archductor-archive-keyring.gpg
sudo install -Dm644 /tmp/archductor-archive-keyring.gpg \
  /usr/share/keyrings/archductor-archive-keyring.gpg
sudo curl -fsSLo /etc/apt/sources.list.d/archductor.sources \
  https://www.perceo.ai/apt/archductor.sources
sudo apt update
sudo apt install archductor archductor-desktop
DNF (Fedora)
sudo curl -fsSLo /etc/yum.repos.d/archductor.repo \
  https://www.perceo.ai/rpm/archductor.repo
sudo dnf makecache --repo archductor
sudo dnf install archductor archductor-desktop
AppImage
VERSION=0.8.3
curl -Lo archductor-desktop.AppImage \
  https://github.com/perceo-ai/conductor-arch/releases/download/v${VERSION}/archductor-desktop-${VERSION}-x86_64.AppImage
chmod +x archductor-desktop.AppImage
sudo mv archductor-desktop.AppImage /usr/local/bin/archductor-desktop
Arch (AUR)
paru -S archductor
Nix
nix run github:perceo-ai/conductor-arch#archductor -- doctor

Requirements

  • Linux desktop for the Electron app, or the Windows preview build.
  • git for worktrees, branches, diffs, and commits.
  • gh authenticated with gh auth login for PRs, checks, comments, and merges.
  • openssh for SSH repository access.
  • Your existing local codex or claude authentication, if you want agent sessions.

Documentation

InstallCore workflowProject setupRelease readiness