duckbugio/flock

DuckFlock is a service you run on your own server that turns Claude, Anthropic's AI system, into a small software development team you can direct through Telegram. You describe what you want built in a Telegram chat message, and a pipeline of automated AI roles takes it from there: one role plans the work, another writes the code, a third runs tests, a fourth reviews the changes and posts comments, and a fifth decides whether the result is ready or needs another pass. When the work passes review, the system opens a pull request in your code repository automatically. The setup runs as a Docker container, which is a self-contained package you can start with a few terminal commands. You connect it to your Telegram bot account, authorize which Telegram users are allowed to send it instructions, and optionally link it to a Git host such as GitHub, Gitea, or GitLab so it can clone repositories and create branches. Each Telegram conversation gets its own isolated workspace on disk, so different chats cannot see each other's files, and multiple conversations can run at the same time. The system works with a Claude subscription (the same account type used in Claude.ai) or an Anthropic API key, which controls how the AI usage is billed. Voice messages are also supported: record a message in Telegram describing what you want, and the system transcribes it and treats it as a written instruction. The project is primarily aimed at developers who want to delegate routine feature work or code changes to an AI pipeline without manually prompting each step. It is written in Go, MIT licensed, and structured so that Telegram is just one adapter on top of a shared core, with other chat platforms expected to be added later.