pve-agents

pve-agents creates a disposable LXC for a repository, ref, configured agent, and purpose. The dashboard streams the agent's conversation, collects approvals, shows the diff, and lets you push or discard the result. Finished workspaces can be destroyed or reaped safely.

Browser or API → pve-agents controller → Proxmox workspace LXC
                    │                    └─ checkout + coding agent
                    └─ auth, lifecycle, approvals, diff, and GitHub access

Built for one operator on a trusted network. The controller holds infrastructure credentials; workspaces receive only the credentials required for their repository and selected agent.

What you need for real workspaces

• Node 22+ and pnpm for the controller.
• A Proxmox host, workspace pool, private workspace network, and template built with deploy/build-workspace-template.sh.
• A GitHub App for repository clone and push, plus a GitHub OAuth app for operator sign-in.
• At least one configured agent in Settings → Agents.

Each workspace is a real LXC. Size the host for the number of concurrent checkouts and agents you intend to run.

Try the controller locally

Provisioning is off by default. Run the controller without Proxmox to explore the UI, API, and workspace lifecycle safely:

pnpm install
cp .env.example .env
pnpm dev

Open http://127.0.0.1:3000. See Quick start for details.

Next steps