Skip to content

Add multi-project support: run on multiple repos with one bot #3

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wadim wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Add multi-project support: run on multiple repos with one bot #3

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9881caf
feat: multi-project support with forum topic routing
wadim Mar 11, 2026
8ecc55f
fix: correct forum setup steps in CLI wizard
wadim Mar 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions super_turtle/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,18 @@ This project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added
- **Multi-project support**: run SuperTurtle on multiple projects simultaneously — each project gets its own forum topic in a Telegram supergroup, with messages routed automatically
- Dedicated router process: single Telegram poller that routes updates to project instances via Unix domain sockets, replacing per-instance polling
- Auto-topic creation: starting `superturtle start` in a new directory auto-creates a forum topic with a deterministic emoji name (e.g. `🐢 my-app`)
- Duplicate detection: starting a second instance in the same directory shows a friendly message pointing to the existing topic instead of creating a conflict
- Thread registry: topic assignments persist in `~/.superturtle/projects.json` so instances reuse their topic across restarts
- Global env: bot token, allowed users, and API keys stored in `~/.superturtle/.env` (shared across all projects)

### Changed
- `superturtle start` now starts a router process alongside the bot (transparent to single-instance users)
- Configuration moved from per-project `.superturtle/.env` to global `~/.superturtle/.env` (existing configs are migrated automatically)

## [0.2.3] - 2026-03-09

### Added
Expand Down
1 change: 1 addition & 0 deletions super_turtle/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,7 @@ superturtle init --token <BOT_TOKEN> --user <TELEGRAM_USER_ID> --openai-key <KEY
3. **Long-running, multi-step work** — spawns parallel SubTurtles.
4. **Milestone updates** — you get progress, not noise.
5. **Works from anywhere** — phone, tablet, another machine.
6. **Multi-project** — run on several projects at once, each in its own forum topic.

## Architecture

Expand Down
Loading