Kosmos — Slack Bot That Boots Any GitHub Repo

The challenge

Non-developer team members wanted to evaluate new GitHub projects but couldn't run them. Cloning, installing dependencies, troubleshooting environments — each repo evaluation was a multi-hour developer task that didn't scale across a curious team dropping links overnight.

The solution

Kosmos is a Slack bot running on a Mac Studio that automates the entire pipeline. Drop a repo URL in any channel — Kosmos clones it, detects whether it's a web service, CLI tool, or TUI/host-install, and routes accordingly. Web and CLI repos boot in Docker and return as a public + LAN URL (or an interactive shell in the thread); TUI repos install directly on the Mac with a launch command. Same URL while live? It returns the existing one — no rebuild. Containers self-expire at 24h or restart on natural-language request like "bring it back for another day". Beyond that: free-form research chat with shell + web access, REPORT.md generation, Paperclip org/agent management, and a Saturday weekly digest of the team's top finds.

Results

• → Auto-detects web service / CLI / TUI repos — zero manual config
• → Web and CLI repos return a live public + LAN URL within seconds
• → Interactive shell access for CLI tools directly inside Slack threads
• → 24h container auto-expire keeps the Mac clean; natural-language restore brings repos back
• → Free-form research chat with shell + web tool access
• → Auto-generated REPORT.md for each evaluated project
• → Saturday weekly digest summarising the team's top finds

Tech stack

• Slack API
• Python
• Docker
• GitHub API
• Mac Studio
• LLM Tool Use