Open Project

Purpose: Quickly navigate to any project in ~/projects/ by name or partial match.

Usage: /open <project-name> or /open to list all projects

Project Directory Structure

~/projects/
├── 01-ACTIVE/          <- Primary work (most used)
├── 02-COACHING-SPIRITUAL/
├── 03-BUSINESS-VENTURES/
├── 04-HERMETIC-TECH/
├── 05-AUTOMATION-TOOLS/
├── 06-ALQVIMIA/
├── 07-CONTENT-KNOWLEDGE/
├── 08-DEVELOPMENT/
├── 09-CLIENT-WORK/
├── 10-ARCHIVED/
└── [loose projects at root]

Step-by-Step Procedure

Step 1: Parse Input

If {args} is provided:

• •Treat as project name or partial match
• •Case-insensitive matching

If no args:

• •List all projects with categories

Step 2: Search for Project

Search order (priority):

1. •Exact match in any category
2. •Partial match (contains) in 01-ACTIVE first
3. •Partial match in other categories
4. •Fuzzy match if no direct matches

Search command:

# Find all project directories (depth 2 for categorized, depth 1 for loose)
find ~/projects -maxdepth 2 -type d -name "*{query}*" 2>/dev/null | grep -v "^\.$"

Step 3: Handle Results

If single match found:

1. •Change working directory to project
2. •Read project's CLAUDE.md if it exists
3. •Show project status (git status, recent files)
4. •Report ready to work

If multiple matches found:

1. •List all matches with full paths
2. •Ask user to specify which one
3. •Show category for each (e.g., "01-ACTIVE", "10-ARCHIVED")

If no matches found:

1. •List similar project names (fuzzy suggestions)
2. •Offer to list all projects in a category

Step 4: Open the Project

When project is identified:

# Change to project directory
cd ~/projects/{category}/{project-name}

# Check for project-specific instructions
if [ -f CLAUDE.md ]; then
    echo "Found project CLAUDE.md"
fi

# Show project status
git status --short 2>/dev/null || echo "Not a git repo"
ls -la

Actions to perform:

1. •Read CLAUDE.md (project instructions) if exists
2. •Read README.md if exists and no CLAUDE.md
3. •Show git status
4. •List recent files modified

Output Format

When Opening Successfully

Opened: {project-name}
Path: ~/projects/{category}/{project-name}

{Show CLAUDE.md contents if exists}

Git Status:
{git status output}

Recent Activity:
{5 most recently modified files}

When Listing Projects

Projects in ~/projects/:

01-ACTIVE (primary work):
  - hermetic-ormus-caduceus
  - LibreUIUX-Claude-Code
  - meta-learning
  ...

02-COACHING-SPIRITUAL:
  - chaos-wheel-site
  ...

[continue for other categories]

When Multiple Matches

Multiple projects match "{query}":

1. 01-ACTIVE/hermetic-ormus-caduceus
2. 01-ACTIVE/hermetic-ormus-dojo
3. 10-ARCHIVED/hermetic-agents-pack

Which one? (enter number or more specific name)

Example Usage

Example 1: Exact Match

User: /open caduceus
Claude: Opens ~/projects/01-ACTIVE/hermetic-ormus-caduceus

Example 2: Partial Match

User: /open lib
Claude: Opens ~/projects/01-ACTIVE/LibreUIUX-Claude-Code (only match containing "lib")

Example 3: Multiple Matches

User: /open hermetic
Claude: Lists all projects containing "hermetic", asks which one

Example 4: List All

User: /open
Claude: Lists all projects organized by category

Example 5: Category Browse

User: /open active
Claude: Lists all projects in 01-ACTIVE/

Quick Reference - Active Projects

These are in 01-ACTIVE/ (most used):

Notes

• •01-ACTIVE is primary - Search there first
• •10-ARCHIVED contains old projects - Warn if opening archived
• •CLAUDE.md is priority - Always read if exists
• •Git status matters - Show uncommitted changes immediately
• •Syncthing synced - These sync to Windows machine

Last Updated: 2026-01-06 Status: Active