BrightVision Core documentation

BrightVision Core is a biforkation (fork²): Cecli → Cecli → this repo, with bright_vision_core/ ported from our earlier engine. Product support: BrightVision. Cecli terminal community: cecli.dev. Upstream Cecli docs also live under cecli/website/ in the repository — not overwritten.

Documentation for the headless engine package (bright-vision-core). For the desktop app, see BrightVision. For upstream tutorials and leaderboards, see cecli.dev/docs.

Start here

• Installation — pip install bright-vision-core, bright-vision-core-serve
• Scripting — CLI scripting and HTTP API for headless clients
• Git — commits, undo, submodule workspaces
• Configuration — models, keys, options

Fork vs upstream

Topic	Here	Upstream
HTTP API / Vision serve	Scripting	—
Submodule monorepos	Git	basic git docs
LLMs, repomap, usage	mirrored docs	cecli.dev/docs

• Installation — Install bright-vision-core and run the CLI or HTTP server.
  • Optional steps
  • Cecli with docker
  • GitHub Codespaces
  • Replit
• Usage — How to use the engine CLI in your local git repo.
  • Tips — Tips for AI pair programming with cecli.
  • In-chat commands — Control cecli with in-chat commands like /add, /model, etc.
  • Chat modes — Using the code, architect, ask and help chat modes.
  • Tutorial videos — Intro and tutorial videos made by cecli users.
  • Voice-to-code with cecli — Speak with cecli about your code!
  • Images & web pages — Add images and web pages to the cecli coding chat.
  • Prompt caching — Cecli supports prompt caching for cost savings and faster coding.
  • Cecli in your IDE — Cecli can watch your files and respond to AI comments you add in your favorite IDE or text editor.
  • Notifications — Cecli can notify you when it's waiting for your input.
  • Cecli in your browser — Cecli can run in your browser, not just on the command line.
  • Specifying coding conventions — Tell cecli to follow your coding conventions when it works on your code.
  • Copy/paste with web chat — Cecli works with LLM web chat UIs
  • Linting and testing — Automatically fix linting and testing errors.
  • Editing config & text files — Use cecli to edit configuration files, documentation, and other text-based formats.
• Connecting to LLMs — Cecli can connect to most LLMs for AI pair programming.
  • OpenAI
  • Anthropic
  • Gemini
  • GROQ
  • LM Studio
  • xAI
  • Azure
  • Cohere
  • DeepSeek
  • Ollama
  • OpenAI compatible APIs
  • OpenRouter
  • GitHub Copilot
  • Vertex AI
  • Amazon Bedrock
  • Other LLMs
  • Model warnings
• Configuration — Information on all of cecli's settings and how to use them.
  • API Keys — Setting API keys for API providers.
  • Options reference — Details about all of cecli's settings.
  • YAML config file — How to configure cecli with a YAML config file.
  • Config with .env — Using a .env file to store LLM API keys for cecli.
  • Editor configuration — How to configure a custom editor for cecli's /editor command
  • Reasoning models — How to configure reasoning model settings from secondary providers.
  • Advanced model settings — Configuring advanced settings for LLMs.
  • Model Aliases — Assign convenient short names to models.
• Troubleshooting — How to troubleshoot problems with cecli and get help.
  • File editing problems
  • Model warnings
  • Token limits
  • cecli not found
  • Dependency versions
  • Models and API keys
  • Using /help
• Screen recordings — Screen recordings of cecli building cecli.
  • Add language support via tree-sitter-language-pack — Watch how cecli adds support for tons of new programming languages by integrating with tree-sitter-language-pack. Demonstrates using cecli to script downloading a collection of files, and using ad-hoc bash scripts to have cecli modify a collection of files.
  • Add –auto-accept-architect feature — See how a new command-line option is added to automatically accept edits proposed by the architect model, with implementation. Cecli also updates the project's HISTORY file.
  • Don’t /drop read-only files added at launch — Follow along as cecli is modified to preserve read-only files specified at launch when using the /drop command. Cecli does this implementation and adds test coverage.
  • Warn when users apply unsupported reasoning settings — Watch the implementation of a warning system that alerts users when they try to apply reasoning settings to models that don't support them. Includes adding model metadata, confirmation dialogs, refactoring, and comprehensive test coverage.
• Example chat transcripts
  • Editing an asciinema cast file with cecli
  • Download, analyze and plot US Census data
  • Improve css styling of chat transcripts
  • Complete a css exercise with cecli
  • Hello cecli!
  • Honor the NO_COLOR environment variable
  • Build pong with cecli and pygame.
  • Semantic search & replace code with cecli
  • Automatically update docs with cecli
  • Create a simple flask app with cecli
  • Modify an open source 2048 game with cecli
  • A complex multi-file change, with debugging
  • Create a “black box” test case
• More info — Advanced topics, scripting, and HTTP API.
  • Git integration — Git integration and submodule workspaces (Vision Core).
  • Supported languages — Cecli supports pretty much all popular coding languages.
  • Repository map — Cecli uses a map of your git repository to provide code context to LLMs.
  • Scripting & headless API — CLI scripting, Python API, and bright-vision-core-serve HTTP API.
  • Infinite output — Cecli can handle "infinite output" from models that support prefill.
  • Edit formats — Cecli uses various "edit formats" to let LLMs edit source files.
  • Analytics — Opt-in, anonymous, no personal info.
  • Privacy policy
• FAQ — Frequently asked questions about cecli.
• Release history — Release notes and stats on cecli writing its own code.
• Cecli LLM Leaderboards — Quantitative benchmarks of LLM code editing skill.
  • Code editing leaderboard — Quantitative benchmark of basic LLM code editing skill.
  • Refactoring leaderboard — Quantitative benchmark of LLM code refactoring skill.
  • Scores by release date
  • Benchmark notes
  • Contributing results