Centralized knowledge for AI agents. Track insights across projects. Never lose context again.
# Install
curl -sSL https://raw.githubusercontent.com/KakkoiDev/aidb/master/install.sh | sh
# Initialize
aidb init
aidb init --remote git@github.com:user/kb.git # With remote syncStarting a new task → Check for existing knowledge
aidb list --unseen # Find unread filesAfter learning something → Mark as processed
aidb seen <file> # Mark file as seen
aidb unseen <file> # Re-queue for attentionTracking files → Add to knowledge base
aidb add <file> # Track file (creates symlink)
aidb remove <file> # Untrack file (restores original)Syncing knowledge → Git versioning
aidb status # Show changes
aidb commit "message" # Commit changes
aidb push # Push to remote
aidb pull # Pull from remote| Command | Description |
|---|---|
aidb init |
Initialize ~/.aidb |
aidb add <file> |
Track file (move to ~/.aidb, create symlink) |
aidb remove <file> |
Untrack file (restore to original location) |
aidb list |
List tracked files (excludes _aidb/) |
aidb list --unseen |
Show files needing attention |
aidb list --aidb |
Show only _aidb/ knowledge files |
aidb seen <file> |
Mark file as processed |
aidb unseen <file> |
Re-queue file for processing |
aidb status |
Show git status |
aidb commit "msg" |
Commit changes |
aidb push |
Push to remote |
aidb pull |
Pull from remote |
Two-tier knowledge system for pattern extraction:
| Tier | Location | Purpose |
|---|---|---|
| Project | ~/.aidb/{project}/{branch}/_aidb/ |
Insights specific to that project |
| Global | ~/.aidb/_aidb/ |
Patterns across all projects |
# Tracked files
aidb list --unseen
# Knowledge files (_aidb/)
aidb list --unseen --aidb
# Mark as processed
aidb seen project/_aidb/patterns.md- Files stored in
~/.aidb/{repo}/{branch}/{path-relative-to-repo-root} - Symlinks created at original locations
- Git versioning for history and sync
- Seen/unseen tracking with automatic change detection (modified files become unseen)
Inside a git repo the store path is relative to the repo root regardless of the
directory aidb add runs from. Before v0.3.x it was cwd-relative, so files
added from a subdirectory back then may live at a different store path than new
adds; no migration is performed. Paths outside the current project are refused.
# Initialize with remote
aidb init --remote git@github.com:user/kb.git
# Configure remote later
cd ~/.aidb && git remote add origin <url>Custom installation path
BINDIR=~/.local/bin make install- Git
Binary (recommended)
curl -sSL https://raw.githubusercontent.com/KakkoiDev/aidb/master/install.sh | shGo install
go install github.com/KakkoiDev/aidb/cmd/aidb@latestFrom source
git clone git@github.com:KakkoiDev/aidb.git && cd aidb
make build && make installUninstall
make uninstallmake publish V=fix # 0.3.0 → 0.3.1
make publish V=feature # 0.3.0 → 0.4.0
make publish V=major # 0.3.0 → 1.0.0
make publish V=1.2.3 # explicit versionTags and pushes to trigger the GitHub Actions release workflow.
Works with Cursor, Windsurf, Codex, Aider, Devin, and 20+ tools.
# Already at repo root as AGENTS.md
# Copy to project root for workspace-specific use
cp AGENTS.md /path/to/project/Deeper integration for Claude Code and GitHub Copilot.
# Claude Code
mkdir -p ~/.claude/skills/aidb && cp SKILL.md ~/.claude/skills/aidb/
# GitHub Copilot
mkdir -p ~/.copilot/skills/aidb && cp SKILL.md ~/.copilot/skills/aidb/
# Cursor (rename to .mdc)
mkdir -p .cursor/rules && cp SKILL.md .cursor/rules/aidb.mdcFull automation with knowledge harvesting subagent.
mkdir -p ~/.claude/agents && cp AGENTS.md ~/.claude/agents/aidb.mdMIT