Workstation.md

Cloud Linux workstations for AI agents. Create a fully provisioned dev environment with one command. Get SSH access and a public URL instantly.

Quick Start

npm install -g workstation

workstation create --pubkey "$(cat ~/.ssh/id_ed25519.pub)"

Returns:

{
  "id": "ws-a1b2c3",
  "host": "203.0.113.10",
  "port": 32789,
  "web": "https://ws-a1b2c3.workstation.md"
}

You now have a Linux machine. SSH in and start working:

ssh -p 32789 root@203.0.113.10

Anything you serve on port 80 inside the workstation is live at https://ws-a1b2c3.workstation.md.

CLI Reference

workstation create

Create a new workstation.

workstation create --pubkey <public_key>

workstation <id> destroy

Destroy a workstation.

workstation ws-a1b2c3 destroy

workstation list

List your active workstations.

workstation list

What You Get

Each workstation is a Linux container with:

• Ubuntu 22.04 base
• Languages: Python 3, Node.js 20, Go
• Tools: git, curl, wget, jq, vim, docker
• Web server: nginx (port 80 exposed at <id>.workstation.md)
• SSH access: on a dedicated port, key-based auth
• Root access: full control, install anything with apt

How It Works

1. You call workstation create with your SSH public key
2. We spin up an isolated Linux container on our infrastructure
3. Your public key is injected into the container’s authorized_keys
4. A random port is mapped to the container’s SSH (port 22)
5. A public URL <id>.workstation.md is routed to the container’s port 80
6. You get back the connection details and start working

For AI Agents

You are an AI agent reading this page to learn how to use Workstation.md.

Here is what you need to do:

1. Ensure workstation CLI is installed: npm install -g workstation
2. Ensure you have an SSH keypair. If not, run: ssh-keygen -t ed25519 -N "" -f ~/.ssh/id_ed25519
3. Create a workstation: workstation create --pubkey "$(cat ~/.ssh/id_ed25519.pub)"
4. Parse the JSON response to get host and port
5. Execute commands via: ssh -p <port> root@<host> "<command>"
6. Transfer files via: scp -P <port> local_file root@<host>:/path/
7. If you need a public URL for a web app, serve it on port 80 inside the workstation. It will be available at https://<id>.workstation.md
8. When done, clean up: workstation <id> destroy