Skip to content

co-l/openfox

Repository files navigation

OpenFox

Local-LLM-first agentic coding assistant

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

Session — Criteria tracking, tool calls, and streaming responses Session

Providers — Local LLM backend configuration Providers

Workflows — Contract-driven execution pipeline Workflows

Quick Start

npm i -g openfox
openfox

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

CLI Commands

# 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

CLI Options

Option Description Default
-p, --port <number> Specify server port 10369
--no-browser Don't open browser on start Opens browser
-h, --help Show help message -
-v, --version Show version number -

Requirements

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

Features

  • 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

Screenshots

Homepage — Project overview and session history Homepage

Project Selected — Active session with context stats Project Selected

Stats — Prefill time, generation speed, token usage Stats

Terminal — Integrated terminal for running commands Terminal

Notifications — Event log and system messages Notifications

Agents — Sub-agent management and execution Agents

General Instructions — Global custom instructions General Instructions

Vision Fallback — Image processing configuration Vision Fallback

License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages