Ada is a public alpha semantic sidecar for Git.
It helps AI-heavy engineering teams inspect code semantically instead of only as text. Today, Ada is not a Git replacement. Git still handles commits, branches, merges, and remotes. Ada layers on:
- semantic snapshots in a local
.ada/SQLite store - semantic diff for supported languages
- local query and proposal workflows
- a lightweight local dashboard
- Git-vs-Ada eval scenarios
Ada v0.1.0-alpha.2 is intentionally narrow:
- Ada is a Git sidecar, not a full VCS replacement
- supported languages are Go and TypeScript/JavaScript
- supported platforms are macOS and Linux
- the local CLI + local UI are the supported product surface
- remote/control-plane pieces exist in the repo but are experimental
Build the CLI:
git clone https://github.com/yesabhishek/ada.git
cd ada
go build -o bin/ada ./cmd/adaCreate a small Git repo to try it on:
mkdir -p /tmp/ada-demo
cd /tmp/ada-demo
git init
git config user.name "Your Name"
git config user.email "you@example.com"
cat > main.go <<'EOF'
package main
func add(a int, b int) int {
return a + b
}
EOF
git add .
git commit -m "initial"Start Ada and create the first semantic snapshot:
/path/to/ada/bin/ada start .
/path/to/ada/bin/ada syncMake a change and inspect it:
cat > main.go <<'EOF'
package main
func add(a int, b int) int {
return a - b
}
EOF
/path/to/ada/bin/ada diff --semantic
/path/to/ada/bin/ada diff --text
/path/to/ada/bin/ada status --sync
/path/to/ada/bin/ada ui --openCommit with Git, then sync Ada again:
git add .
git commit -m "change add logic"
/path/to/ada/bin/ada syncSupported alpha commands:
ada start .
ada sync
ada status --sync
ada diff --semantic
ada diff --text
ada ask "add"
ada task add "Refactor cache"
ada propose "Semantic merge proposal"
ada resolve "Keep Thread B's logic."
ada rewind search "before auth refactor"
ada rewind apply <snapshot-id> --dry-run
ada ui --open
ada eval
ada eval --format markdown
ada version
ada doctorPublic-alpha distribution paths:
- direct binary download from GitHub Releases
- install script:
curl -fsSL https://raw.githubusercontent.com/yesabhishek/ada/main/scripts/install.sh | bash - Homebrew tap for macOS/Linux
Until the first release is tagged, local go build is the reliable path.
ada diff --semanticafter a small code editada ui --opento watch snapshots and sync stateada evalto compare built-in Git vs Ada merge scenarios
ada syncrequires a clean Git working tree- Ada does not replace
git commit,git merge,git push, orgit pull - the local UI is read-only
- the remote/control-plane code is experimental and not part of the supported alpha workflow
Apache-2.0. See LICENSE.