Welcome to CodeLoop¶
CodeLoop is a lightweight Python library for building agentic coding assistants — in the shape of Claude Code, Codex, or Gemini CLI. Give it a provider and a prompt, it drives a tool-use loop (read, write, edit, grep, bash, web fetch, MCP) until the task is done.
Every piece is injected, not hardcoded: swap the LLM backend, the tool set, or the system prompt without touching the agent loop. Bare pycodeloop starts a full-screen chat; run covers one-shot and scripted use; serve speaks JSON-RPC over stdio for editor integrations (see the VS Code extension). Skills already on disk (Claude Code, Cursor, AGENTS.md) are discovered automatically.
Start with the basics here.
Getting Help¶
We use GitHub issues for tracking bugs and feature requests.
Commit Style¶
| Icon | Type | Description |
|---|---|---|
| ⚙️ | FEATURE | New feature |
| 📝 | PEP8 | Formatting fixes following PEP8 |
| 📌 | ISSUE | Reference to issue |
| 🪲 | BUG | Bug fix |
| 📘 | DOCS | Documentation changes |
| 📦 | PyPI | PyPI releases |
| ❤️️ | TEST | Automated tests |
| ⬆️ | CI/CD | Changes in continuous integration/delivery |
| ⚠️ | SECURITY | Security improvements |
License¶
This project is licensed under the terms of the MIT License.