Tip Of AI
Discover what you can do with AI
runspace is a command line interface and Model Context Protocol server for running development tasks inside disposable GitHub Codespaces. It allows humans and AI agents to create isolated cloud sandboxes, execute commands, copy files, inspect changes, and remove sandboxes when work is complete. The local host only runs a single static binary and retains no repository configuration, daemon, or persistent sandbox state. The tool supports Linux, macOS, and Windows on amd64 and arm64 systems. Its main commands include create, exec, cp, diff, run, ls, delete, and mcp. The run command creates a sandbox, runs one command, returns the exit code and output, and deletes the sandbox. Longer workflows can create a sandbox, run formatting scripts, builds, tests, or other commands, then export all changes since creation as one patch. The patch can be reviewed and applied locally with standard Git commands. runspace connects to Codespaces through SSH and the Dev Tunnel using a GitHub token with the required Codespaces scope. It supports MCP clients so agents can use the same commands and validation rules as terminal users. Sandboxes can access the internet and may incur Codespaces charges. Codespaces run for up to 12 hours and idle out after configured periods. The project is available under the MIT License and works only with github.com.