opencommand 0.1.2

Local-first swarm agent framework: a Commander plans and dispatches a swarm of Workers that research, code, test, and interactively drive the computer to complete long-horizon codebase goals.

OpenCommand

Local-first swarm agent framework. A Commander model plans and dispatches a swarm of Workers that research, code, test, and interactively drive the computer (mouse, keyboard, screen) to complete long-horizon codebase goals.

Everything runs embedded — models are GGUF files loaded directly with llama-cpp-python (no API servers, no network at runtime). Designed for Python 3.14 (free-threaded).

Install

# Run without installing (ephemeral):
uv tool run opencommand --help

# Or install globally:
uv tool install opencommand
playwright install   # optional, for the playwright tool

Note: the llama-cpp-python prebuilt CPU wheel may crash on older CPUs (illegal-instruction). If so, rebuild from source with AVX2:

call "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvars64.bat"
set CMAKE_ARGS=-DGGML_AVX2=ON
uv pip install --no-binary llama-cpp-python --no-cache llama-cpp-python

Usage

opencommand models list                 # list built-in embedded models
opencommand models pull all             # download GGUF models into ./models
opencommand config                      # interactive menu: workers, batch size, GPU, etc.
opencommand run "Add unit tests for the engine module."
opencommand run --goal-file Goal.md    # run from a Goal.md spec (intended state)
opencommand run "Build a Panda3D FPS" --pipeline advanced --verify "uv run pytest -q"
opencommand tui                         # live swarm dashboard
opencommand cron add healthcheck "every 1h" "echo ok"

Goal.md spec

Instead of an inline goal, point run at a Goal.md file that defines the intended end state / requirements for the session. Its contents become the goal fed to the swarm (and the advanced pipeline's review gate checks against it):

opencommand run --goal-file Goal.md

The file name is configurable via opencommand config (default Goal.md).

Built-in models

Role	Model
commander	deepreinforce-ai/Ornith-1.0-9B-GGUF
worker	unsloth/Qwen3-4B-Instruct-2507-GGUF
vision	unsloth/Qwen3-VL-4B-Instruct-GGUF
vision_small	openbmb/MiniCPM-V-4.6-gguf

Links

• DESIGN.md — full architecture & research notes
• TODO.md — roadmap tracker