Quickstart
Get a remote, isolated workspace running in minutes.
1) Install
curl -fsSL https://raw.githubusercontent.com/gricha/perry/main/install.sh | bash
Alternative installs and build-from-source are in Installation.
2) Start the agent
Run this on the machine that will host workspaces:
perry agent run
Web UI is at http://localhost:7391.
3) Create a workspace
perry start myproject
Or clone a repo on creation:
perry start myproject --clone git@github.com:user/repo.git
4) Connect
perry shell myproject
You can also use the Web UI terminal, or SSH if the workspace is on your tailnet.
5) Optional: Tailscale
If Tailscale is configured, each workspace gets a tailnet hostname and your agent is reachable remotely. Start with Networking when you are ready.