CodeLoop is a sophisticated Electron-based desktop application that provides a modern, intuitive user interface for managing AI-powered code generation pipelines. It automates the entire software development lifecycle—from cloning a repository and creating an implementation plan to writing, reviewing, and fixing code, and finally submitting a pull request.
At its core, CodeLoop orchestrates predefined workflow scripts in scripts/ (for example, development-auto-pr.sh and pr-autofix.sh) to run multi-step automation with various large language models.
- Full Pipeline Management: Automates Clone, Setup, Plan, Implement, Review, Fix, Commit, Push, and PR phases.
- Multi-Model Support: Support for leading models including Claude 4.5/4.6, GPT-5/4o, Gemini 3.0/3.1, and more.
- Real-time Monitoring: Track pipeline progress phase-by-phase with a built-in log viewer and status indicators.
- Configurable Workspaces: Easily manage your development root and custom post-clone setup commands.
- Repository Picker: Quick access to recent repositories and easy validation of local git repos.
- Interactive Configuration: Fine-tune specific models for each phase of the pipeline (e.g., use Claude for planning and GPT for reviewing).
- Workflow Selection: Choose a predefined workflow at run start, with a configurable default workflow in Settings.
Before running CodeLoop, ensure you have the following installed:
- Node.js & pnpm: Required for the Electron desktop app.
- GitHub CLI (
gh): Follow the GitHub CLI installation guide. Ensure you are authenticated viagh auth login. - OpenCode CLI: The underlying tool for model interactions. Visit opencode.ai for installation details.
-
Clone this repository:
git clone https://github.com/natelindev/code-loop.git cd code-loop -
Install dependencies:
pnpm install
-
Start the development server:
pnpm dev
- Build distributable desktop artifacts (DMG/ZIP on macOS):
pnpm build
- Build an unpacked app directory only (faster local validation):
pnpm build:dir
Build output is written to the release/ directory.
On the first launch, CodeLoop will create a default configuration in ~/.code-loop.json. You can manage these settings directly within the app's Settings panel:
- Workspace Root: The directory where repositories will be cloned and managed.
- Model Selection: Choose different models for planning, implementing, reviewing, etc.
- Post-Clone Commands: Custom scripts (like
pnpm i) to run after cloning a repo.
- Frontend: React + Vite + Tailwind CSS + Shadcn UI
- Backend: Electron (Node.js)
- Core Logic: Bash pipeline script
- IPC: Secure communication between renderer and main process for script execution and file system access.
This project is licensed under the MIT License - see the LICENSE file for details.