Self-hosted web UI for running and managing GitHub Copilot CLI sessions.

Copilot Spawner gives you a clean web interface to:

• browse folders in a workspace
• start Copilot CLI sessions (--remote / --yolo)
• watch and interact with live PTY terminals in-browser
• stop/delete sessions
• resume from recent history
• clone repos, create folders, and invite collaborators

Copy/paste this in Copilot CLI:

Deploy Copilot Spawner on this Linux machine using https://raw.githubusercontent.com/MauroDruwel/Copilot-Spawner/main/docs/copilot-cli-deploy-prompt.md

The prompt asks setup questions first (including whether to create a user systemd service), defaults to stable releases, and supports uv or venv + pip.

Stable install (latest release tag):

git clone https://github.com/MauroDruwel/Copilot-Spawner.git
cd Copilot-Spawner
git fetch --tags
git checkout "$(git describe --tags --abbrev=0)"

uv venv .venv
.venv/bin/uv pip install -r requirements.txt

export COPILOT_SPAWNER_PASSWORD='change-me'
export COPILOT_SPAWNER_SECRET="$(python3 -c 'import secrets; print(secrets.token_hex(32))')"
.venv/bin/python app.py

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python app.py

Open: http://127.0.0.1:8765

• Tags use vX.Y.Z format (example: v0.1.0).
• Pushing a version tag triggers the Release workflow automatically.
• You can also trigger release manually via Actions → Release with a version input.

• Keep it behind localhost + reverse proxy for public access.
• Set strong values for COPILOT_SPAWNER_PASSWORD and COPILOT_SPAWNER_SECRET.
• Use TLS termination (for example Cloudflare Tunnel or Nginx/Caddy).

PRs welcome. See CONTRIBUTING.md, SECURITY.md, and CODE_OF_CONDUCT.md.

MIT © 2026 Mauro Druwel