<!-- Language Handling: Check ~/.ypm/config.yml for settings.language --> <!-- If language is not "en", translate all output to that language -->

YPM Setup - Initial Configuration

Set up YPM for global usage. This command creates the data directory and configuration file.

What This Command Does

1. Create ~/.ypm/ directory for YPM data
2. Create ~/.ypm/config.yml with your settings (interactive)
3. Optionally link commands to ~/.claude/commands/ for prefix-free access

---

Execution Steps

STEP 1: Check Existing Installation

ls -la ~/.ypm/config.yml 2>/dev/null && echo "EXISTS" || echo "NOT_FOUND"

If EXISTS: Ask user if they want to reconfigure or skip setup.

If NOT_FOUND: Proceed to STEP 2.

---

STEP 2: Create Data Directory

mkdir -p ~/.ypm

Report to user:

Created ~/.ypm/ directory for YPM data.

---

STEP 3: Configure Monitoring Directories

Use AskUserQuestion to collect configuration:

Question 1: Project Directories

Question:

Which directories contain your projects?
Enter absolute paths, one per line or comma-separated.

Examples:
  - /Users/yourname/Projects
  - /Users/yourname/Work
  - ~/Src (will be expanded)

Collect: List of directories to monitor

Question 2: Detection Patterns

Question:

How are your projects organized within these directories?

Select patterns that match your structure:

Options (multiSelect: true):

1. Direct children - Projects are direct subdirectories (e.g., ~/Projects/my-app)
2. Grouped by category - Projects are in category folders (e.g., ~/Projects/web/my-app)
3. Prefixed directories - Projects use prefixes (e.g., ~/Src/proj_/)

Question 3: Activity Thresholds

Question:

How do you want to classify project activity?

Options:

1. Default - Active: 7 days, Inactive: 30 days
2. Relaxed - Active: 14 days, Inactive: 60 days
3. Strict - Active: 3 days, Inactive: 14 days

---

STEP 4: Generate config.yml

Use Write tool to create ~/.ypm/config.yml:

# YPM Configuration
# Generated by /ypm:setup

monitor:
  # Directories containing your projects
  directories:
    - /path/to/your/projects
    # Add more directories as needed

  # Patterns to detect projects within directories
  patterns:
    - "*"           # Direct children
    # - "*/*"       # One level deep
    # - "proj_*/*"  # Prefixed directories

  # Directories/patterns to exclude from scanning
  exclude:
    - node_modules
    - vendor
    - .git
    - __pycache__

  # Projects to hide from /ypm:open (but still scanned)
  ignore_in_open: []

# Editor configuration
editor:
  default: code    # code, cursor, zed, terminal

# Activity classification thresholds
classification:
  active_days: 7       # Updated within N days = active
  inactive_days: 30    # No updates for N days = inactive

---

STEP 5: Optional - Link Commands for Prefix-Free Access

Use AskUserQuestion:

Question:

Would you like to access YPM commands without the 'ypm:' prefix?

This will create symbolic links in ~/.claude/commands/
so you can use /update instead of /ypm:update

Options:

1. Yes - Create links (commands available as /start, /update, etc.)
2. No - Keep prefix (commands available as /ypm:start, /ypm:update, etc.)

If Yes:

# Get plugin directory (where commands are installed)
PLUGIN_DIR="$(dirname "$(dirname "$0")")"  # This needs to be determined

# Create symlinks
mkdir -p ~/.claude/commands
for cmd in ~/.claude/plugins/ypm/commands/*.md; do
  ln -sf "$cmd" ~/.claude/commands/
done

Note: The actual plugin path may vary. If automatic linking fails, provide manual instructions:

To enable prefix-free commands, run:

  YPM_PLUGIN_DIR=$(find ~/.claude -name "ypm" -type d 2>/dev/null | head -1)
  for cmd in "$YPM_PLUGIN_DIR/commands"/*.md; do
    ln -sf "$cmd" ~/.claude/commands/
  done

---

STEP 6: Verify Installation

cat ~/.ypm/config.yml

Display configuration and confirm:

YPM Setup Complete!

Configuration: ~/.ypm/config.yml
Data file: ~/.ypm/PROJECT_STATUS.md (will be created on first update)

Next steps:
1. Review your configuration: cat ~/.ypm/config.yml
2. Run your first scan: /ypm:update (or /update if linked)

Your projects will be scanned from:
  - /path/to/your/projects
  - ...

---

Reconfiguration

To reconfigure YPM, run this command again. It will detect the existing configuration and ask if you want to update it.

Uninstall

To remove YPM data:

rm -rf ~/.ypm
rm ~/.claude/commands/ypm*.md  # If links were created

---

Always confirm successful setup with the user.