gitwtfhub

wtf is borg?

turborg/borg — explained in plain English

Analysis updated 2026-05-18

4GoAudience · developerComplexity · 3/5LicenseSetup · easy

TL;DR

A small terminal based AI coding agent that edits files and runs commands until a task is verified done, working with either your own local model or a hosted one.

Mindmap

mindmap
  root((repo))
    What it does
      Edits files and runs commands
      Verifies its own work
      Terminal REPL interface
    Tech stack
      Go single binary
      OpenAI compatible backends
      Ollama LM Studio support
    Use cases
      Fix a failing test
      Build a small app from a prompt
      Resume a past coding session
    Audience
      Developers
      Vibe coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run a local coding agent against your own Ollama or LM Studio model with no account or API key.

REASON 2

Ask the agent to fix a failing test or build a small app from a single prompt.

REASON 3

Have the agent study a repository and write a project context file for future sessions.

REASON 4

Use hosted frontier models through OpenAI or OpenRouter for harder multi-step coding tasks.

What's in the stack?

GoOllamaOpenAI API

How it stacks up

turborg/borgaeneasr/github-trendsbxcodec/go-simple-flatbuffer
Stars444
LanguageGoGoGo
Last pushed2020-12-182017-06-09
MaintenanceDormantDormant
Setup difficultyeasyeasyeasy
Complexity3/52/52/5
Audiencedeveloperpm founderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Installs as a single static binary, using your own model needs a local server like Ollama already running.

Use, modify, and distribute freely, including commercially, as long as you keep the license and copyright notices and note any changes you made.

Wtf does this do

Borg is a small AI coding assistant that lives in your terminal. You give it a task in plain English, and it reads your files, makes edits, runs commands, and keeps checking its own work against your project's build or test setup until the task is actually finished, rather than just guessing once and stopping. What sets it apart is how it connects to an AI model. You can point it at a model running entirely on your own computer through tools like Ollama or LM Studio, at other services such as OpenAI or OpenRouter, or you can log into the maker's own hosted service, xShellz, and use their models instead through a metered plan. The agent itself, its tools, and the way it works stay identical no matter which option you pick, so switching backends is just a setting change. The tool ships as a single small program with no separate install steps for a runtime or extra dependencies, and it uses very little memory while idle. It asks for permission before it is allowed to write files inside a folder, and any actions like editing or running shell commands happen right there on your own machine. Only the actual thinking, the AI model call itself, goes out to wherever that model is hosted. If you use your own local model, no code or key ever leaves your computer, and any provider key you do use is read from your environment rather than being written to a settings file. Inside its interactive mode you can switch models, ask it to study a project and write itself some notes about it, resume earlier conversations, and check how much of its available context window is being used. It works with tool-calling capable local models such as Qwen 2.5 Coder, or with larger hosted models for more difficult tasks. The project is open source under the Apache 2.0 license, which allows free use, modification, and distribution, including commercially, as long as you keep the license and copyright notices and note any changes you make.

Yoink these prompts

Prompt 1
Set up borg with Ollama and qwen2.5-coder so I can run a local coding agent with no API key.
Prompt 2
Use borg to fix the failing test in my current project.
Prompt 3
Have borg study this repository and write a BORG.md project context file.
Prompt 4
Explain how to point borg at a custom OpenAI-compatible endpoint like LM Studio.

Frequently asked questions

wtf is borg?

A small terminal based AI coding agent that edits files and runs commands until a task is verified done, working with either your own local model or a hosted one.

What language is borg written in?

Mainly Go. The stack also includes Go, Ollama, OpenAI API.

What license does borg use?

Use, modify, and distribute freely, including commercially, as long as you keep the license and copyright notices and note any changes you made.

How hard is borg to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is borg for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.