# Woodshed

> Cloud dev environments for coding agents. Each environment runs the
> full stack (database, services, app) so an agent can run and test a
> change before a human reviews it.

## Install

Pick one:

- Hosted: sign in at https://console.woodshed.run with GitHub. New
  accounts get $20 in free compute credits.
- Self-hosted: clone https://github.com/ChifferCo/woodshed and follow
  its README. https://woodshed.run/self-host.html has the steps for
  Docker on any machine or an AWS account of its own.

Install the command line on your computer with Node 22 or newer:

```sh
curl -fsSL https://woodshed.run/cli | sh
```

Then ask your coding agent to "set up Woodshed": it runs `woodshed setup`, which covers sign-in (approve it in your
browser), repos, connecting Claude Code and Codex, and reviews. To give your agent the Claude Code and Codex skill too,
ask it to "set up Woodshed with its skill": it first runs the install command with `sh -s -- --yes`. Run the installer
again to upgrade.

For automation, download the installer to a temporary file and run it only after curl succeeds.

```sh
(
  installer=$(mktemp "${TMPDIR:-/tmp}/woodshed-cli.XXXXXX") || exit 1
  trap 'rm -f "$installer"' 0
  curl -fsSL https://woodshed.run/cli -o "$installer" && sh "$installer"
)
```

## Configure a repo

Create `.woodshed/project.yaml` at the repo root. It declares:

- env files
- dependency install
- database migrate and seed
- how to start and stop the app, and on which ports
- how to prove a change works

Put your own rules for agents in `.woodshed/rules.md`.

## Sessions

- Start sessions from the console.
- Each session runs Claude Code or Codex, with the user's own login.
- Each session has its own branch and its own running copy of the app.

## Links

- Source: https://github.com/ChifferCo/woodshed
- License: AGPL-3.0. Paid team features in ee/.
- Website: https://woodshed.run
