🎯 Overview

Command-line interface for Branch Context, a per-branch context folder for AI agents and humans. Sets up Git hooks, manages templates, and keeps _branch/context.md in sync with the active branch.

🚀 Quick Start

npm i -g branch-context

Then, inside any Git repo:

bctx init

This creates .bctx/ and installs the post-checkout / post-commit hooks. _branch/context.md is now always pointed at the active branch's context.

🧰 Commands

# other commands
bctx backup
bctx base [branch]
bctx global <path>
bctx init
bctx prune
bctx status
bctx sync
bctx template [name] [--list]
bctx uninstall

For branch-scoped Pi sessions, install the Pi package from GitHub:

pi install git:github.com/lucasvtiradentes/branch-context

It records the current Git branch into new Pi session files via pi.appendEntry().

⚙️ Configuration

Default .bctx/config.json:

{
  "default_base_branch": "origin/main",
  "sound": true,
  "commit_description": false
}

📜 License

MIT