# Install globally
npm install -g @sigaostudios/sigao-cli

# Or run directly with npx
npx @sigaostudios/sigao-cli

# Interactive setup (recommended)
sigao

# Install all components
sigao --yes

# Install specific components
sigao -c node,docker,python,claude

# List available components
sigao --list

# Dry run mode
sigao --dry-run

# Generate workpackage from PRD
sigao generate requirements.md workpackage.json

# Execute workpackage
sigao work workpackage.json --output-dir ./project

# Use specific Claude model
sigao work workpackage.json --model opus
sigao work workpackage.json --model sonnet

# Preview execution
sigao work workpackage.json --dry-run

# Show help index
sigao help

# Get help for specific tool
sigao help git
sigao help docker
sigao help work

# Use pager for long help
sigao help -p zoxide

# Quick command reference
sigao cheat

# Search for pattern
rg "TODO"

# Search specific file types
rg -t js "console.log"

# Search with context
rg -C 3 "error"

# Ignore patterns
rg --glob "!node_modules" "import"

# Find files by name
fd "test.js"

# Find by extension
fd -e md

# Execute commands
fd -e js -x prettier --write

# View file with highlighting
bat README.md

# Show line numbers
bat -n file.js

# Compare files
bat --diff file1 file2

# Tree view
eza --tree

# Long format with git status
eza -l --git

# Icons and colors
eza --icons

# Jump to frequently used directory
z project

# Interactive selection
zi

# List matched directories
z -l dev

# Find and open file
vim $(fzf)

# Search command history
<Ctrl+R>

# Kill process interactively
kill -9 $(ps aux | fzf | awk '{print $2}')

# Launch lazygit
lazygit

# Stage, commit, push with UI
# Navigate with arrow keys
# Press ? for help

# Create .envrc file
echo "export API_KEY=secret" > .envrc

# Allow direnv to load it
direnv allow

# Auto-loads when entering directory
cd project/

# Launch btop
btop

# Sort by CPU: c
# Sort by Memory: m
# Kill process: k

# Launch htop
htop

# Filter processes: F4
# Sort: F6
# Kill: F9

# Pretty print JSON
cat data.json | jq .

# Extract field
cat data.json | jq '.users[0].name'

# Filter array
cat data.json | jq '.items[] | select(.active == true)'

# View markdown
glow README.md

# Browse directory
glow

# Pager mode
glow -p documentation.md

# Navigation
alias ..='cd ..'
alias ...='cd ../..'
alias ll='eza -la'
alias la='eza -la'
alias lt='eza --tree'

# Git shortcuts
alias gs='git status'
alias ga='git add'
alias gc='git commit'
alias gp='git push'
alias gl='git log --oneline'

# Safety nets
alias rm='rm -i'
alias cp='cp -i'
alias mv='mv -i'

# Utilities
alias ports='netstat -tulanp'
alias myip='curl ipinfo.io/ip'

# Make directory and enter it
mkcd() {
    mkdir -p "$1" && cd "$1"
}

# Extract any archive
extract() {
    # Handles .tar.gz, .zip, .7z, etc.
    # Usage: extract file.tar.gz
}

# Git commit with message
gcm() {
    git commit -m "$*"
}

# Configure Claude
claude --help

# Used automatically by workpackages
sigao work package.json

# Check auth status
gh auth status

# Create repo
gh repo create

# Create PR
gh pr create

# Browse issues
gh issue list

# Node.js via NVM
sigao -c node

# Python via pyenv
sigao -c python

# Docker & Docker Compose
sigao -c docker

# .NET SDK
sigao -c dotnet

# Modern CLI tools bundle
sigao -c cli-tools

# Git enhancements
sigao -c git-enhanced

# Python tools (black, mypy, etc.)
sigao -c python-tools

# Shell enhancements
sigao -c shell-enhancements

# Sigao paths
export SIGAO_HOME="$HOME/.sigao"
export PATH="$SIGAO_HOME/bin:$PATH"

# Tool configurations
export FZF_DEFAULT_OPTS="--height 40% --layout=reverse"
export BAT_THEME="TwoDark"
export EZA_COLORS="di=34:ln=35:ex=32"

~/.config/
├── bat/          # Bat configuration
├── htop/         # Htop settings
├── lazygit/      # Lazygit config
└── starship.toml # Prompt configuration

# Find files
vim $(fd -t f | fzf)

# Change directories
cd $(fd -t d | fzf)

# Git branches
git checkout $(git branch | fzf)

# Add to ~/.bashrc
# Quick project search and open
project() {
    cd $(fd -t d -d 3 . ~/projects | fzf) && code .
}

# Search and edit
se() {
    rg --files-with-matches "$1" | fzf | xargs -r $EDITOR
}

# Convert script to workpackage
sigao generate migration-script.md migration.json
sigao work migration.json

# Reload shell configuration
source ~/.bashrc  # or ~/.zshrc

# Check PATH
echo $PATH | tr ':' '\n' | grep sigao

# Reinstall component
sigao -c <component>

# Fix npm permissions
npm config set prefix ~/.npm
export PATH="$HOME/.npm/bin:$PATH"

# Fix tool permissions
chmod +x ~/.sigao/bin/*

# Disable heavy features
export FZF_DEFAULT_COMMAND='fd --type f'
export DISABLE_AUTO_UPDATE=true

# Use faster alternatives
alias grep='rg'
alias find='fd'