Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 24 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,17 @@
# BitterGit

BitterGit is an experimental Git-compatible source-custody service for
AI-assisted app workflows. It uses ordinary Git repositories underneath and
adds app-oriented history, checkpoints, restore, workcell credentials, import
review, and source-linked receipts around them.
BitterGit is an open-source, self-hosted Git service for AI coding agents. It
keeps ordinary Git repositories as the source of truth and adds scoped
credentials, checkpoints, restore, import review, and source-linked records
around them.

This repository contains the Apache-2.0 server implementation.
BitterGit is the source-custody layer in [Bitter](https://bitter.sh/), a
prepared workspace and CLI for agentic coding, but it can also run on its own.
[BitterGit.com](https://bittergit.com/) describes the product and its hosted
direction, which is currently in early access. Bitter's account, workspace,
agent, secret, deployment, and support services are not bundled in this
repository.

> [!WARNING]
> BitterGit is alpha software. It has strong local verification coverage, but
Expand All @@ -13,10 +21,18 @@ review, and source-linked receipts around them.

## Why it exists

AI tools can create source quickly, but durable custody still requires a real
repository, scoped credentials, recoverable history, and an exact source
revision for every deploy. BitterGit explores that layer without requiring
GitHub as the first step and without inventing a new version-control protocol.
Starting an app in Bitter should not require creating or connecting a GitHub
account first. For someone who does not already use GitHub, that adds another
account and another setup step before an agent can do useful work. BitterGit
gives each app an ordinary Git repository from the beginning, so its source
stays cloneable, exportable, and compatible with standard Git tools. GitHub and
other providers can still be connected later as mirrors or external sources;
they are options, not prerequisites.

AI tools can create code quickly, but keeping that code under your control
still requires scoped write access, recoverable history, and an exact commit
behind every deploy. BitterGit handles that layer without replacing Git with a
custom version-control protocol.

The project currently includes:

Expand Down
13 changes: 10 additions & 3 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "bittergit",
"version": "0.1.0",
"description": "Experimental Git-compatible source custody for AI-assisted app workflows",
"description": "Open-source, self-hosted Git service for AI coding agents",
"license": "Apache-2.0",
"private": true,
"type": "module",
Expand All @@ -13,11 +13,18 @@
"type": "git",
"url": "https://github.com/sheetgenius/bittergit.git"
},
"homepage": "https://bittergit.com/",
"bugs": {
"url": "https://github.com/sheetgenius/bittergit/issues"
},
"keywords": [
"agentic-coding",
"ai-agents",
"git",
"git-server",
"self-hosted",
"source-control",
"source-custody",
"ai-agents"
"source-custody"
],
"scripts": {
"start": "bun run src/server.ts",
Expand Down