Window Management CLI Tool with AI Integration using package manager approach for configuration management.

# Build from source
git clone <repository-url>
cd claude-wm-cli
make build

# The binary will be available at ./build/claude-wm-cli

# 1. Install system configuration
claudewm config install

# 2. Check configuration status
claudewm config status

# 3. Update configuration (preview first)
claudewm config update --dry-run
claudewm config update

# 4. Initialize project workspace
claudewm init my-project

• config install - Install system config to .claude/ and .wm/baseline/
• config status - Show differences between upstream, baseline, and local
• config update --dry-run - Preview configuration updates
• config update --no-backup - Update without creating backups
• config migrate-legacy - Migrate from .claude-wm to .wm structure

• dev sandbox - Create testing sandbox from upstream files
• dev sandbox diff --apply - Apply sandbox changes to baseline
• dev sandbox diff --only <pattern> - Apply specific files only
• dev sandbox diff --allow-delete - Allow file deletion during sync

• guard check - Validate changes against writing restrictions
• guard install-hook - Install git pre-commit validation hook

• init <project> - Initialize new project with proper structure
• status - Show current project state and progress
• execute "command" - Execute Claude commands with timeout protection

Claude WM CLI uses a 4-space configuration model:

• Upstream (A): internal/config/system - Embedded system templates
• Baseline (B): .wm/baseline - Installed reference state
• Local (L): .claude - User workspace and customizations
• Sandbox (S): .wm/sandbox/claude - Testing environment

Upstream (A) ──┐
               ├─→ 3-way merge ──→ Local (L)
Baseline (B) ──┘

• --dry-run - Preview changes without applying
• --no-backup - Skip backup creation during updates
• --only <pattern> - Apply only matching files/patterns
• --allow-delete - Allow file deletion during operations
• --apply - Apply changes after preview
• --timeout <seconds> - Custom timeout for execute commands
• --retries <count> - Custom retry count for execute commands

• Architecture Guide - Detailed technical architecture
• Configuration Guide - Complete command reference with flags
• Testing Guide - L0-L3 testing protocols and make test-all
• Knowledge Base - Glossary, commands reference, file ownership rules
• ADR - Architectural Decision Records
• MCP Playbook - MCP tools usage guide

# Safe configuration update with preview
claudewm config update --dry-run  # Preview changes
claudewm config update             # Apply changes

# Sandbox testing workflow
claudewm dev sandbox                           # Create sandbox
claudewm dev sandbox diff                      # Show differences
claudewm dev sandbox diff --apply --only cmd/  # Apply only cmd/ changes

# Project initialization
claudewm init my-project
cd my-project
claudewm status

• Atomic operations with automatic backups
• 3-way merge conflict detection
• File ownership boundary enforcement
• Git pre-commit hooks for validation
• Dry-run mode for safe previews

See docs/ for complete documentation.