Concepts

CodeLoop has four moving pieces:

Config(provider, tools) → CodeLoop → Agent → loop(Provider ↔ Tools) → Session

• Agent loop — the tool-use loop that drives a conversation until the model stops calling tools.
• Providers — the LLM backend abstraction. GenericProvider drives any HTTP chat-completions-style API (Anthropic, OpenAI, Ollama, LM Studio, ...) via JSON config, no vendor SDK; a custom Provider subclass covers anything else.
• Tools — the actions the agent can take: read/write/edit files, grep, run shell commands, or call an MCP server.
• Config — the dependency-injection container that wires a provider and a tool set together.