BuildFlow transforms web content into actionable code and research reports. It targets developers, researchers, and power users seeking to automate the process of understanding, implementing, and documenting interesting online discoveries, from articles and tutorials to GitHub repositories and X/Twitter posts. The primary benefit is a streamlined workflow that automates research and code generation from a single click or message.

How It Works

BuildFlow employs a multi-component architecture: a Chrome extension and a Telegram bot act as user interfaces, sending URLs or X/Twitter posts to a backend server. This server then communicates with the OpenCode AI-powered coding assistant, which performs automated research. OpenCode analyzes content, identifies key concepts, implements example code, runs tests, and generates a comprehensive report, including source code and cloned repositories. This approach automates the entire pipeline from discovery to a documented, working implementation.

Quick Start & Requirements

• Prerequisites: Node.js 20+, pnpm 9+, OpenCode AI assistant (configured with an AI provider like Anthropic or OpenAI), Telegram Bot Token (optional).
• Installation: Install OpenCode (curl -fsSL https://opencode.ai/install | bash or npm install -g opencode), clone BuildFlow (git clone https://github.com/BowTiedSwan/buildflow.git), cd buildflow, pnpm install, pnpm build, and configure the .env file. Sisyphus Agent installation is recommended for enhanced orchestration (git clone https://github.com/code-yeongyu/oh-my-opencode.git ~/.opencode/oh-my-opencode).
• Running: Start OpenCode (opencode serve --port 4096 in your desired research directory), start the backend (pnpm backend), load the Chrome extension (chrome://extensions -> Developer mode -> Load unpacked packages/chrome-extension/dist/), and optionally start the Telegram bot (pnpm bot).
• Links: OpenCode (opencode.ai), Sisyphus Agent (github.com/code-yeongyu/oh-my-opencode).

Highlighted Details

• Custom OpenCode Agent: Features a dedicated research-builder.md agent within .opencode/agent/ optimized for web content research, code implementation, testing, and report generation, with bash and webfetch permissions.
• Structured Output: Generates research folders containing REPORT.md (summary, concepts, implementation, tests, applications, assessment), src/ (working code examples), and repo/ (cloned repositories).
• X/Twitter Integration: The browser extension injects a "🔨" button on X/Twitter posts for immediate research initiation.

Maintenance & Community

The project is authored by BowTiedSwan (@BowTiedSwan). No specific details on other contributors, sponsorships, or community channels (like Discord/Slack) are provided in the README.

Licensing & Compatibility

The project is released under the MIT License, which is permissive for commercial use and integration into closed-source projects.

Limitations & Caveats

This project has significant external dependencies, requiring a running OpenCode instance (which in turn needs a configured AI provider) and potentially the Sisyphus Agent. Managing concurrent services, particularly ensuring only one OpenCode instance serves port 4096, is crucial. Ad blockers may interfere with the browser extension's functionality. The setup involves multiple installation and configuration steps across different services.