Project / Overview

Agentworks

AI coding agents can now do substantial work autonomously. Spinning up a few is easy; operating many safely, persistently, and concurrently is an infrastructure problem.

Agentworks is a toolkit for that infrastructure: VMs, workspaces, agents, sessions, harnesses, configuration, secrets, and the systems that connect them.

Create and manage an agentic fleet from your own workstation. Durable agents run as separate Linux users in VMs on infrastructure you choose and control. They retain their own tools, git credentials, and accumulated application state (a coding assistant's context and memory, interactive logins). Disposable sessions spin up against them for a single piece of work and are thrown away when done. One agw CLI drives all of it declaratively via an SSH-over-Tailscale control plane.

Get started

Choose your setup path

The Agentworks control plane currently runs on a single machine, called the “workstation.” This is the machine you use to manage and access your Agentworks system. The workstation can also host Agentworks VMs, but it does not have to: where the control plane runs is independent of where you place the VMs that host your workloads.

via Agent

Copy this prompt into any capable assistant.

# Agentworks setup

I'd like your help getting up and running with Agentworks, a CLI for configuring and operating
development environments, workspaces, and sessions for coding agents.

You are running on the Agentworks workstation, which hosts the control plane. Agentworks VMs may run
here or elsewhere.

The public repository is available at <https://github.com/WayfarerLabs/agentworks> if you or I need
to inspect the source before installing. The CLI is self-documenting through its help and guide
output, with additional notes for assistant agents.

The CLI is published on PyPI as `agentworks-cli`. The recommended installation method is `uv`,
although other Python tool installers should work with Python 3.12 or newer.

```shell
uv tool install --upgrade agentworks-cli
```

Once installed, run `agw guide --agent` and follow its guidance to get started.

Manual

Start by browsing the repository, then install the CLI with uv or another Python tool installer. Agentworks requires Python 3.12 or newer.

uv tool install agentworks-cli
# or
pipx install agentworks-cli

Once installed, open the guide and follow the setup path it recommends.

agw guide