Local-LLM-first agentic coding assistant

Autonomous coding agent for local LLMs with contract-driven execution.

Session — Criteria tracking, tool calls, and streaming responses

Providers — Local LLM backend configuration

Workflows — Contract-driven execution pipeline

npm i -g openfox
openfox

On first run, OpenFox automatically detects your local LLM backend (vLLM, sglang, ollama, llamacpp) and configures itself.

• Multi-Turn Agent Engine — Completely rewritten agent loop with EventStore as single source of truth. All modes (builder, planner, verifier, sub-agents, compaction) run through the same unified loop.
• Provider Dialog — Comprehensive provider configuration UI with thinking mode (reasoningEffort), editable kwargs, profile defaults, and preset management.
• Auto-Retry Patterns — Replace the old XML protection toggle with configurable pattern matching. Define your own retry triggers in settings.
• Unified Image Handling — Automatic vision model fallback for non-vision models. Images are described before each turn so any model can "see" them.
• Session Metadata — Unified session_metadata tool replaces separate criterion/todo tools. Interactive criteria editor with CRUD and agent badges.
• Workflow Sub-Groups — Run individual workflow steps in isolation. New code review phase in the build-verify pipeline.
• Parallel edit_file Safety — Per-file mutex prevents race conditions when editing multiple files simultaneously.
• Firefox Support — Custom thin scrollbars with hover behavior, cross-browser compatible.

# Start server for current project
openfox

# Start on custom port
openfox --port 8080

# Start without opening browser
openfox --no-browser

# Show current configuration
openfox config

# Manage LLM providers
openfox provider add      # Add new provider
openfox provider list     # List configured providers
openfox provider use      # Switch active provider
openfox provider remove   # Remove provider

• Node.js >= 24.0.0
• Local LLM backend with OpenAI-compatible API:
  • vLLM
  • sglang
  • ollama
  • llamacpp

• Plan → Builder Workflow: Interactive task breakdown followed by autonomous implementation
• Contract-Driven Execution: Acceptance criteria serve as immutable contract
• Iterative Verification: Agent loops until all criteria pass
• LSP Integration: Immediate feedback on code validity
• Real-Time Metrics: Prefill time, generation speed, context usage

OpenFox supports provider plugins loaded from the plugins directory inside its configuration folder. Plugins can add authentication methods, transports, provider presets, and model discovery without adding provider-specific code to the OpenFox core.

You can install the plugin manually or directly from the UI.

Default plugin directories:

• macOS: ~/Library/Application Support/openfox/plugins
• Linux: ${XDG_CONFIG_HOME:-~/.config}/openfox/plugins
• Windows: %APPDATA%\openfox\plugins

Restart OpenFox after installing or updating a plugin.

• To authenticate with a ChatGPT Plus or Pro account, you can install the openfox-chatgpt plugin.
• To authenticate with a Github copilot account, you can install the openfox-github-copilot plugin.
• To authenticate with a Google Antigravity account, you can install the openfox-google-antigravity plugin.

Homepage — Project overview and session history

Project Selected — Active session with context stats

Stats — Prefill time, generation speed, token usage

Terminal — Integrated terminal for running commands

Notifications — Event log and system messages

Agents — Sub-agent management and execution

General Instructions — Global custom instructions

Vision Fallback — Image processing configuration

MIT