brew install charliek/tap/shed
brew install charliek/tap/shed-host-agent  # optional: credential brokering

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://apt.stridelabs.ai/pubkey.gpg | \
  sudo tee /etc/apt/keyrings/apt-charliek.gpg > /dev/null
echo 'deb [signed-by=/etc/apt/keyrings/apt-charliek.gpg] https://apt.stridelabs.ai noble main' | \
  sudo tee /etc/apt/sources.list.d/apt-charliek.list
sudo apt update
sudo apt install shed-server

git clone https://github.com/charliek/shed.git
cd shed
make build

# Or install the CLI only
go install github.com/charliek/shed/cmd/shed@latest

npx skills add charliek/shed

shed server add my-server.local --name my-server

# Create an empty shed
shed create my-project

# Or clone a repository
shed create my-project --repo git@github.com:user/repo.git

# Or mount a local directory as the workspace
shed create my-project --local-dir ~/projects/my-project

# Pick a specific image alias or ref (base / extensions / full; default_image is used otherwise)
shed create big-project --image full --upper-size 20G

# Open a terminal session
shed console my-project

# Or use VS Code/Cursor with SSH Remote
# The shed ssh-config command generates SSH config entries
shed ssh-config >> ~/.ssh/config

# Create with VZ backend (default on macOS)
shed create myproject

# With custom resources
shed create myproject --cpus=4 --memory=8192

# Create with Firecracker backend (default on Linux)
shed create myproject

# With custom resources
shed create myproject --cpus=4 --memory=8192

# Clone a private repo (requires SSH credentials configured)
shed create myproject --repo=git@github.com:user/repo.git

# Shed Management
shed create <name> [--repo URL]  # Create a new shed (or --local-dir PATH)
shed list                        # List all sheds on the current server
shed start <name>                # Start a stopped shed
shed stop <name>                 # Stop a running shed
shed reset <name>                # Wipe and recreate the per-shed writable upper
shed delete <name> [--force]     # Delete a shed

# Connection & Execution
shed console <name>              # Open direct terminal session
shed attach <name>               # Attach to tmux session (persistent)
shed attach <name> -S <session>  # Attach to named session
shed exec <name> <cmd>           # Run command in shed

# Image Management
shed image build                 # Build an OCI image from a Dockerfile
shed image ls                    # List images by ref (SOURCE: config/user/dangling; alias: list)
shed image history <tag>         # Show the layer stack for an image
shed image inspect <tag-or-digest>  # Show manifest + annotations + digest
shed image pull <ref>            # Pull an OCI image registry-direct
shed image push <src> <dst>      # Push a tag/digest to a registry (byte-perfect)
shed image save <tag> -o <file>  # Save an image to an OCI archive
shed image load -i <file>        # Load an OCI archive into the local store
shed image tag <src> <new>       # Point a new tag at an existing digest
shed image rm <ref|digest|label> # Remove an image from the ref-index (alias: delete)
shed image prune                 # Reclaim unreferenced layer blobs

# Session Management
shed sessions                    # List all sessions on default server
shed sessions <name>             # List sessions in a specific shed
shed sessions --all              # List sessions across all servers
shed sessions kill <shed> <session>  # Kill a session

# Port Forwarding
shed tunnels start <name> -t <ports>  # Forward ports from a shed
shed tunnels stop <name>              # Stop port forwarding
shed tunnels list                     # List active tunnels

# Server & IDE
shed server add <name>           # Add a server to client config
shed server list                 # List configured servers
shed server remove <name>        # Remove a server from client config
shed ssh-config                  # Generate SSH config for IDE integration

# Create a shed and attach to a persistent session
shed create myproj --repo user/repo
shed attach myproj

# Inside the session, start an agent
claude

# Detach with Ctrl-B D (tmux default)
# The agent keeps running!

# Later, reattach to see progress
shed attach myproj

# List all active sessions
shed sessions --all