> ## Documentation Index
> Fetch the complete documentation index at: https://docs.perceo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Requirements

> What has to be installed and authenticated before Archductor is useful.

Archductor drives tools you already have. It does not bundle or proxy them, and it
does not store credentials.

| Tool               | Required for                                |
| ------------------ | ------------------------------------------- |
| `git`              | Worktrees, branches, diffs, commits         |
| `gh`               | GitHub PR creation, checks, comments, merge |
| `openssh`          | SSH repository access                       |
| `codex`            | Codex sessions                              |
| `claude`           | Claude Code sessions                        |
| `cursor` or `code` | Editor and session launch when configured   |

Run `gh auth login` before using any PR feature. Codex and Claude Code use your
existing local CLI authentication.

## Platform

* **Linux** — primary validated target. Requires a desktop with GTK4/libadwaita
  support. CI covers glibc, musl, Debian, and Fedora.
* **Windows** — preview target. Native GTK4/libadwaita build; see
  [Install](/archductor/install).
* **WSL** — supported as a Linux environment, but it is not a substitute for a
  native Windows build.

Source builds additionally need Rust plus the GTK4 and libadwaita development
packages.

<Note>
  Agent CLIs are optional. Archductor works with Shell sessions alone if you only
  want isolated worktree workspaces and a review surface.
</Note>