Phantom is a powerful CLI tool for managing Git worktrees with an elegant, developer-friendly interface. Built with TypeScript and modern Node.js, it provides a streamlined workflow for parallel development, making it easy to work on multiple features, bug fixes, and code reviews simultaneously.

• Zero Runtime Dependencies - Lightweight and fast execution
• TypeScript - Type-safe codebase with modern ES modules
• Clean Architecture - Separation of concerns with CLI, Core, and Git layers
• Comprehensive Testing - Unit tests with native Node.js test runner
• Modern Tooling - esbuild for fast builds, Biome for code quality

• Development Setup - Set up your development environment
• Quick Start - Get running in 5 minutes
• Architecture Overview - High-level system design
• Core Concepts - Essential concepts and terminology

• Technology Stack - Languages, frameworks, and tools
• System Design - Architecture patterns and principles
• Module Structure - Code organization
• Data Flow - How data moves through the system

• Testing Strategy - Overall testing approach
• Unit Testing - Writing and running tests

• Local Development - Running locally
• Debugging - Debugging techniques
• Code Styles - Coding conventions

• Build Process - How to build the project
• CI/CD - Continuous integration and deployment

• Repository: github.com/aku11i/phantom
• npm Package: @aku11i/phantom
• Issue Tracker: GitHub Issues
• CI/CD Pipeline: GitHub Actions

• Node.js: v22.0.0 or higher
• Package Manager: pnpm (recommended) or npm
• Git: Modern version with worktree support

# Install globally
npm install -g @aku11i/phantom

# Create a new phantom (worktree)
phantom create <name> [branch]

# List all phantoms
phantom list

# Execute command in phantom
phantom exec <name> <command>

# Enter phantom shell
phantom shell <name>

# Delete phantom
phantom delete <name>

For detailed documentation, explore the sections above or check out the Quick Start Guide.