co-l/openfox

What it solves

OpenFox provides an autonomous coding assistant specifically optimized for local LLMs. It solves the challenge of implementing complex coding tasks by using a contract-driven approach, ensuring that the agent continues to iterate until a predefined set of acceptance criteria are met.

How it works

The system operates through a "Plan $\rightarrow$ Builder" workflow where tasks are first broken down into a plan and then autonomously implemented. It uses a multi-turn agent engine with an EventStore as the single source of truth, allowing for various modes like planning, verifying, and using sub-agents. To ensure code quality, it integrates with Language Server Protocol (LSP) for immediate validity feedback and employs a per-file mutex to prevent race conditions during parallel file edits.

Who it’s for

It is designed for developers who prefer running their LLM backends locally (using tools like vLLM, Ollama, sglang, or llamacpp) and want an agentic workflow for software development.

Highlights

• Contract-Driven Execution: Uses acceptance criteria as immutable contracts to guide the agent.
• Local-First Design: Automatic detection and configuration for major local LLM backends.
• Extensible Plugin System: Supports adding new providers, tools, skills, and UI elements without restarting.
• Unified Image Handling: Implements a vision model fallback that describes images for non-vision models.
• Declarative Workflows: Supports multi-step pipelines including agent turns, shell commands, and user gates.