Headless Cecli engine for Vision

This repository is the core of BrightVision: a beheaded, API-first biforkation (Cecli → Cecli → BrightVision Core) that powers the native desktop app. It is not another VS Code clone — the UI lives in React and Tauri; this package is the pair-programming brain you run locally or embed via HTTP.

We track upstream Cecli closely and add only what Vision needs: structured sessions, submodule-aware git workspaces, and reliable headless operation.

Install & serve Get BrightVision Core docs

Who builds what

BrightVision

The product we support: a ground-up desktop GUI (Rust + React), not an IDE skin. Install, settings, chat UX, and day-to-day help — bright-vision.digitaldefiance.org.

BrightVision Core (this repo)

Python engine fork: CLI, HTTP API, git/submodule logic, and docs for integrators. Issues here should be engine or API bugs; praise and roadmap belong upstream or on the Vision site.

Cecli (engine upstream)

First fork after Aider. cecli.dev — cecli-dev/cecli. We bundle cecli/ and merge by file tier.

Vision Core additions

Capabilities added for BrightVision and other headless clients. Everything else in the docs below still describes the shared Cecli engine unless noted.

HTTP API & SSE

Run bright-vision-core-serve and drive sessions from the Vision app, Tauri, or any client. JSONL-style events over Server-Sent Events; optional bearer auth for local serve.

Headless runtime

Non-interactive stdio and confirmation flows suited to GUI confirm/cancel instead of terminal prompts — the default path when Vision owns the UI.

Git submodule workspaces

Superproject roots with nested submodules: discover repos, track files across submodules, and commit pointer updates from a single workspace root.

Upstream alignment

We merge from dwash96/cecli regularly. Engine behavior, models, and edit formats follow upstream; Vision-only deltas stay small and documented here.

Bundled Cecli engine

Inherited from Cecli — tutorials on cecli.dev/docs (and legacy cecli.chat/docs where concepts overlap).

Cloud and local LLMs

Connect to Claude, GPT, DeepSeek, local models, and most OpenAI-compatible APIs.

Codebase map

Repo map for larger projects so the model sees the right context.

100+ languages

Python, JavaScript, Rust, Go, C++, and dozens more via tree-sitter.

Git integration

Automatic commits with sensible messages; diff and undo with normal git tools.

Linting & testing

Run linters and tests on changes; the model can fix reported problems.

Editor watch mode

Upstream supports IDE-style watch mode in a terminal workflow. BrightVision uses the HTTP API instead of copying that UX.

Getting started (engine)

For the desktop app, use BrightVision. To run or integrate the core directly:

# Install the engine package
python -m pip install -U bright-vision-core

# Headless HTTP server (default http://127.0.0.1:8741)
bright-vision-core-serve --workspace /path/to/git/repo

# Classic CLI (cecli, also installed as aider-ce)
cd /path/to/your/project
cecli --model sonnet --api-key anthropic=<key>

Documentation on this site covers the fork; upstream guides apply to most usage.

Install API & scripting Upstream usage