Bit CLI

> Git with a brain - An intelligent Git wrapper with AI-powered commits, ghost branches, and predictive merge analysis.


Features

$3

- Transparent Passthrough - All git commands work through bit (bit status = git status)
- Smart Init - Auto-detects project type and generates appropriate .gitignore
- AI Commits - Generates meaningful commit messages using AI or rule-based analysis

$3

- Ghost Branches - Hidden experimental branches that don't clutter your branch list
- Virtual Merge - Preview merge conflicts before actually merging
- .bit Directory - Intelligent metadata storage separate from .git

$3

- Symbol Tracking - Track function-level changes, not just file-level
- Hot Zone Detection - Warns when teammates are editing the same functions

Installation

``bash


Install globally

npm install -g bit-cli

Or use npx

npx bit-cli
`

Quick Start

`bash


Initialize a new repository with smart defaults

bit init

Make some changes, then commit with AI

git add .
bit commit

Create a ghost branch for experiments

bit branch --ghost experiment

Preview merge conflicts before merging

bit merge --preview feature-branch

Check for team conflicts

bit hotzone

Analyze code changes

bit analyze
`

Commands

| Command | Description |
|---------|-------------|
| bit init | Initialize repo with smart .gitignore and .bit directory |
| bit commit | AI-powered commit message generation |
| bit commit -m "msg" | Manual commit message |
| bit branch --ghost | Create a ghost (hidden) branch |
| bit branch | List all branches including ghost branches |
| bit checkout --ghost | Checkout a ghost branch |
| bit merge --preview | Preview merge conflicts |
| bit merge | Smart merge with conflict preview |
| bit hotzone | Detect overlapping work with team |
| bit analyze | Analyze code at function/symbol level |
| bit | Passthrough to git |

Configuration

$3

`bash


Required for AI features

OPENAI_API_KEY=sk-your-key-here

Optional

BIT_AI_MODEL=gpt-4o-mini
BIT_DEBUG=true
BIT_LOG_LEVEL=debug
BIT_VERBOSE=true
`

$3

Config stored in ~/.bit/config.json:

`json
{
"ai": {
"provider": "openai",
"model": "gpt-4o-mini",
"maxTokens": 500,
"temperature": 0.7
},
"git": {
"ghostPrefix": "ghost/",
"autoStage": false
},
"ui": {
"colors": true,
"spinners": true
}
}
`

$3

Project-specific config in .bit/config.json overrides global settings.

Architecture

`
bit-cli/
├── src/
│ ├── index.js # CLI entry point
│ ├── commands/ # Command implementations
│ │ ├── init.js
│ │ ├── commit.js
│ │ ├── branch.js
│ │ ├── merge.js
│ │ ├── hotzone.js
│ │ └── analyze.js
│ └── utils/ # Shared utilities
│ ├── ai.js # AI service
│ ├── config.js # Configuration management
│ ├── errors.js # Error handling
│ ├── git.js # Git operations
│ ├── logger.js # Logging
│ └── validation.js # Input validation
├── tests/ # Test files
└── .github/workflows/ # CI/CD
`

Development

`bash


Clone repository

git clone https://github.com/yourusername/bit-cli.git
cd bit-cli

Install dependencies

npm install

Run in development

npm run dev

Run tests

npm test

Run tests with coverage

npm run test:coverage

Lint code

npm run lint

Format code

npm run format
`

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing)
3. Commit your changes (bit commit)
4. Push to the branch (git push origin feature/amazing`)
5. Open a Pull Request

License

MIT License - see LICENSE for details.