Skip to content

bitloops/bitloops

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2,268 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Bitloops logo

Give AI coding agents the context they need to ship production-quality software.

Your AI agent forgets your codebase between sessions. You re-explain the architecture, re-paste rules, re-list constraints. Bitloops captures all of it once — automatically, from your agent conversations — and feeds the right pieces back to every future prompt. Runs locally. Replaces your CLAUDE.md, .cursor/rules, and AGENTS.md.

Fork Star Commits Version Downloads License Local First Agent Agnostic

Website · Docs · Quickstart · DevQL · Discussions

Quick Start

Fast scripted setup installs Bitloops and applies the default daemon config:

macOS, Linux, WSL:

curl -fsSL https://bitloops.com/install.sh | bash -s -- --default-config

Windows PowerShell:

& ([scriptblock]::Create((irm https://bitloops.com/install.ps1))) -DefaultConfig

Then, from inside the repo you want Bitloops to capture:

bitloops init

Prefer to configure manually? Install without the default-config flag, then run:

bitloops configure --web
bitloops init

Work normally with Codex, Claude Code, Cursor, Gemini, Opencode or Copilot. Commit as usual. Bitloops captures the relevant context around every change and keeps your codebase model fresh in the background.

Open the local dashboard:

bitloops dashboard

Other install paths and full setup → Docs

What You Get

  • 🧠 Persistent codebase substrate — files, symbols, dependencies, tests, and history modeled as a queryable graph, not text.
  • 🪶 Automatic context capture — decisions, constraints, and reasoning are pulled from your agent conversations as you work. No markdown file to maintain.
  • 🎯 Relevance-ranked retrieval — every prompt gets the artifacts that actually matter. Not all files. Not random files. The right ones.
  • 🔁 Cross-agent memory — what you decided in Claude Code yesterday guides Cursor today and Copilot tomorrow. Same substrate underneath all of them.
  • 🧾 Provenance from commit to prompt — every commit traces back to the prompt, model, and rejected alternatives that produced it. Two weeks later you can still answer "why."
  • 🗺️ Code City spatial view — a live map of your codebase. Files as buildings, height as size, arcs as dependencies. Filter by what AI touched.
  • 🔍 DevQL — a typed query language for your codebase model. Ask precise questions instead of grepping.
  • 🔒 Local-first — your code isn't stored on our infrastructure. The daemon runs on your machine.
  • 🧩 Drops in alongside your agent — no agent switch, no IDE switch. Bitloops is the substrate underneath.

Why Bitloops Exists

You've already built the workaround. A CLAUDE.md that grew to 2,000 lines. A .cursor/rules folder you copy-paste between projects. An AGENTS.md you swear you'll keep updated. A shell script that concatenates the "right" files into every prompt.

The pattern is always the same: a second brain for your codebase, built in markdown, manually maintained, going stale every week.

AI coding agents are bottlenecked by state, not generation. A codebase isn't fundamentally text — it's a system of files, symbols, APIs, tests, decisions, and history. Most agents force that structured system through an unstructured medium (prompt text, RAG chunks, embeddings) and have to infer the system over and over.

The loop today:

retrieve → infer → act → forget

Bitloops changes the loop to:

capture → persist → rank → serve → refresh

Agents can't reliably change systems they can't model. Bitloops builds and maintains the model.


The Old Way vs The Bitloops Way

You're doing this today With Bitloops
Re-explaining your architecture every session Substrate captured once. Re-served on every prompt.
Hand-writing CLAUDE.md / .cursor/rules / AGENTS.md Decisions and constraints captured automatically from your agent conversations.
Agent re-implements a util that already exists three folders over Static analysis + clone detection feeds existing code into pre-edit context.
"Why is this here?" → the prompt is gone Commit → prompt → rejected alternatives, all traceable.
Five rules files for five agents One substrate. Claude Code, Cursor, Copilot — same model underneath.
RAG embeddings rebuilt every session Long-lived daemon. Index is always-on, always-current.
Repository uploaded and stored on a vendor's infra Runs locally. Code processed, not stored.

How It Works

┌──────────────────────────────────────────────────────────────────────┐
│  Your agent (Claude Code / Cursor / Copilot) makes a request         │
└──────────────────────────────────────────────────────────────────────┘
                                  ↓
┌──────────────────────────────────────────────────────────────────────┐
│  Bitloops hooks capture the prompt, transcript, and tool events      │
└──────────────────────────────────────────────────────────────────────┘
                                  ↓
┌──────────────────────────────────────────────────────────────────────┐
│  Local daemon updates the codebase graph (files, symbols, deps)      │
└──────────────────────────────────────────────────────────────────────┘
                                  ↓
┌──────────────────────────────────────────────────────────────────────┐
│  DevQL ranks and serves the right artifacts back into the agent      │
└──────────────────────────────────────────────────────────────────────┘
                                  ↓
┌──────────────────────────────────────────────────────────────────────┐
│  Commit links to the prompt, model, and decision that produced it    │
└──────────────────────────────────────────────────────────────────────┘

Architecture deep-dive → Docs › Architecture


Who Bitloops Is For

  • Devs shipping multiple AI-assisted PRs per week with Claude Code, Cursor, Copilot, or Codex — who've stopped being amazed and started being annoyed.
  • Anyone maintaining a CLAUDE.md, .cursor/rules, or AGENTS.md and quietly knowing it's already out of date.
  • Engineering teams who want a reviewable trail for AI-assisted work — prompts, tool events, decisions, commits — not just diffs.
  • Platform and DevEx teams building internal AI workflows who need a typed local substrate for agent context.

Supported Agents & Languages

Agents:

  • Claude Code
  • Codex
  • Cursor
  • Gemini
  • Copilot
  • OpenCode

Languages:

  • Rust
  • TypeScript / JavaScript
  • Python
  • Go
  • Java
  • C#
  • PHP
  • C++

Local-First Trust Model

Your code isn't stored on our infrastructure. The daemon runs on your machine; configuration, repository model, event data, and blobs stay local by default.

LLM reasoning over commits, code, and conversations is part of the system — that processing requires sending content to a model provider, and an account is required to authenticate it. The line: your code isn't stored, it is processed.


Demo video

Bitloops Getting Started


Documentation

  • 📖 Quickstart — set up and first capture
  • 🔍 DevQL — query the codebase model
  • 🏗️ Docs home — guides, concepts, troubleshooting
  • 🛠️ Contributing — rules, dev setup, extension guides

Community

  • 💬 GitHub Discussions — questions, ideas, feedback
  • 🐛 Issues — bug reports, feature requests
  • 🔒 Security — responsible disclosure
  • 🤝 Code of Conduct If Bitloops is solving a problem you've felt — star the repo. It tells us we're building the right thing, and it tells other devs the project is real.

License

Apache-2.0. See LICENSE.