> ## 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.

# Quickstart

> Install Archductor and get an agent working on an isolated branch.

Archductor is the fastest way into the suite. This gets you from nothing to an
agent working on its own branch.

<Steps>
  <Step title="Install Archductor">
    On Linux, the AppImage is the shortest path:

    ```bash theme={"dark"}
    curl -Lo archductor.AppImage \
      https://github.com/perceo-ai/conductor-arch/releases/latest/download/archductor-x86_64.AppImage
    chmod +x archductor.AppImage
    sudo mv archductor.AppImage /usr/local/bin/archductor
    ```

    Or use a package manager:

    ```bash theme={"dark"}
    brew tap perceo-ai/tap
    brew install archductor
    ```

    Other channels — AUR, Nix, Windows preview, source builds — are covered in
    [Install](/archductor/install).
  </Step>

  <Step title="Authenticate the tools it drives">
    Archductor shells out to your existing local CLIs. It does not store or proxy
    credentials.

    ```bash theme={"dark"}
    gh auth login
    ```

    Codex and Claude Code use whatever local authentication you already have.
  </Step>

  <Step title="Launch the app">
    ```bash theme={"dark"}
    archductor
    ```

    With no arguments the AppImage opens the GTK app. With arguments it forwards
    to the command-line interface.
  </Step>

  <Step title="Add a project">
    From the Projects page, point Archductor at an existing repository folder or
    clone a Git URL. One project wraps one repository.
  </Step>

  <Step title="Create a workspace">
    Create a workspace from a branch, a prompt, a GitHub issue, a GitHub PR, or a
    Linear issue. The workspace gets its own Git worktree, branch, `.context`
    directory, and a stable `ARCHDUCTOR_PORT` range.

    <Tip>
      One workspace is one branch is one reviewable unit. If two changes should be
      reviewed separately, give them separate workspaces.
    </Tip>
  </Step>

  <Step title="Start an agent and review">
    Start a Shell, Codex, or Claude Code session inside the workspace. When it
    settles, review the changed files, diffs, todos, and comments in the app, then
    create or merge the PR and archive the workspace.
  </Step>
</Steps>

## Where to go next

<CardGroup cols={2}>
  <Card title="Core workflow" icon="git-branch" href="/archductor/workflow">
    Projects, workspaces, branches, and sessions — and how they nest.
  </Card>

  <Card title="Project setup" icon="sliders-horizontal" href="/archductor/project-setup">
    Shared scripts, prompts, and workspace defaults in `.archductor/settings.toml`.
  </Card>

  <Card title="Archivum" icon="book-open" href="/archivum/install">
    Stand up the knowledge layer with the guided installer.
  </Card>

  <Card title="Archfleet" icon="monitor" href="/archfleet/overview">
    Run computer-use agents on isolated VMs.
  </Card>
</CardGroup>