Manage isolated code-server development environments, similar to GitHub Codespaces. Each codespace runs in its own Docker container with a full VS Code editor accessible via browser through Cloudflare Tunnel.
The custom Docker image includes:
Before creating any codespace, build the Docker image once:
bash scripts/codespace.sh setup
This builds codespace-manager:latest from assets/Dockerfile.txt. Only needed once per host.
Script location: scripts/codespace.sh (relative to this skill's directory)
# One-time image build
codespace setup
# Create codespace (optionally clone a repo and/or init OpenCode config)
codespace create <name>
codespace create <name> --git <repo-url>
codespace create <name> --opencode
codespace create <name> --git <repo-url> --opencode
# Lifecycle
codespace start <name> # Start and get Cloudflare Tunnel URL
codespace stop <name> # Stop container and tunnel
codespace restart <name> # Stop then start (new URL)
codespace delete <name> # Remove container + data (irreversible!)
# Info
codespace list # List all codespaces with status
codespace status <name> # Detailed status of one codespace
codespace logs <name> # View container logs
codespace url <name> # Regenerate tunnel URL
# Config
codespace password <pass> # Set default password for new codespaces
codespacecodespace password CODESPACE_PASSWORD=mypass codespace create foo| User says | Command |
|---|---|
| --- | --- |
| "create a codespace called myapp" | codespace create myapp |
| "create a codespace with opencode" | codespace create |
| "set up a dev environment for this repo" | codespace create |
| "start / launch / open myapp" | codespace start myapp |
| "stop / shut down myapp" | codespace stop myapp |
| "delete / remove myapp" | codespace delete myapp (confirm with user first!) |
| "list my codespaces" / "show environments" | codespace list |
| "get the URL for myapp" | codespace url myapp |
| "set password to xyz" | codespace password xyz |
| "create a python project" | codespace create (uv is pre-installed) |
| "create a node/bun project" | codespace create (bun is pre-installed) |
codespace-manager:latest)~/codespaces//project on the hostcodespace setup before first use — it builds the Docker imagecodespace delete is irreversible — confirm with user before executing/home/coder/project) does not persist across delete/recreateWhen --opencode is used, a opencode.json is created in the project root with:
{
"$schema": "https://opencode.ai/config.json",
"model": "anthropic/claude-sonnet-4-5",
"autoupdate": true
}
Users can edit this file in code-server to change the model or add provider keys.
共 1 个版本