ba-kit-cli

ba-kit-cli

CLI tool for scaffolding BA-Kit into your projects.

Installation

npm install -g ba-kit-cli

Usage

Initialize BA-Kit

# Initialize in current directory
ba-kit init

# Initialize in specific directory
ba-kit init ./my-project

# Force overwrite existing installation
ba-kit init --force

# Use specific branch
ba-kit init --branch develop

Check Status

# Show installation status
ba-kit status

# Check for remote updates
ba-kit status --remote

Update BA-Kit

# Interactive update with conflict resolution
ba-kit update

# Auto-accept non-conflicting updates
ba-kit update --yes

# Preview changes without applying
ba-kit update --dry-run

Restore Modified Files

# Interactive file selection
ba-kit restore

# Restore specific file
ba-kit restore skills/core/planning.md

# Restore all modified files
ba-kit restore --all

# Skip confirmation
ba-kit restore --all --yes

Commands

Command	Description
init [path]	Initialize BA-Kit in current or specified directory
status	Show BA-Kit installation status
update	Update BA-Kit to latest version
restore [file]	Restore modified files to original

Options

Global

Option	Description
-V, --version	Display version
-h, --help	Display help

init

Option	Description
-f, --force	Overwrite existing .agent/ folder
-b, --branch <branch>	Branch to use (default: main)
-l, --local <path>	Use local ba-kit source

update

Option	Description
-y, --yes	Auto-accept non-conflicting updates
--dry-run	Show changes without applying
-l, --local <path>	Use local ba-kit source

status

Option	Description
--remote	Check against remote for updates

restore

Option	Description
-a, --all	Restore all modified files
-y, --yes	Skip confirmation prompt
-l, --local <path>	Use local ba-kit source

How It Works

BA-Kit CLI uses a manifest-based approach to track files:

• Init: Downloads BA-Kit from GitHub, copies files to .agent/, creates manifest with SHA-256 hashes
• Status: Compares current file hashes against manifest to detect modifications
• Update: Downloads latest version, detects conflicts between local changes and upstream updates
• Restore: Downloads original files and restores modified files with automatic backups

Manifest

The manifest file (.agent/.ba-kit-manifest.json) tracks:

• Installed version
• Branch used
• File hashes (original and current)
• Installation/update timestamps

Conflict Resolution

When both local and upstream files have changed, the update command offers:

• Keep local: Preserve your modifications
• Overwrite: Accept upstream changes
• View diff: Compare changes side-by-side
• Backup & overwrite: Save local copy before updating

Development

# Clone the repo
git clone https://github.com/anthropics/ba-kit-cli.git
cd ba-kit-cli

# Install dependencies
npm install

# Link for local development
npm link

# Test with local ba-kit source
ba-kit init --local /path/to/ba-kit

License

MIT