Skip to content

Installation

Get Claude Commands Library running in your project in under 2 minutes.

Prerequisites

Before installing, ensure you have:

Verify your setup:

powershell
claude --version    # Should show Claude Code version
git --version       # Should show Git version

Quick Installation

One-Line Install

powershell
# Download and run the installer
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Tadzesi/claude-ideas/main/install-claude-commands.ps1" -OutFile "install-claude-commands.ps1"
.\install-claude-commands.ps1

The installer will:

  1. Clone the repository
  2. Deploy .claude/ directory to your project
  3. Preserve existing memory files, deploy new ones (e.g. project-profile.md)
  4. Display available commands

Installation Options

Install to Current Directory

powershell
cd C:\YourProject
.\install-claude-commands.ps1

Install to Specific Directory

powershell
.\install-claude-commands.ps1 -InstallPath "C:\Projects\MyApp"

Force Reinstall

If you have a corrupted installation:

powershell
.\install-claude-commands.ps1 -Force

What Gets Installed

your-project/
├── .claude/
│   ├── commands/           # Slash commands (old format, still works)
│   │   ├── prompt.md
│   │   ├── prompt-hybrid.md
│   │   ├── prompt-technical.md
│   │   ├── prompt-research.md
│   │   ├── prompt-article.md
│   │   ├── prompt-article-readme.md
│   │   └── reflect.md
│   ├── skills/             # Skills format (v4.5, with YAML frontmatter)
│   │   ├── prompt/SKILL.md
│   │   ├── prompt-hybrid/SKILL.md
│   │   ├── prompt-dotnet/SKILL.md
│   │   ├── prompt-react/SKILL.md
│   │   ├── deploy/SKILL.md
│   │   ├── new-stack/SKILL.md
│   │   └── reflect/SKILL.md
│   ├── library/            # Core library system
│   │   ├── prompt-perfection-core.md   # v1.6 - always loads memory first
│   │   ├── adapters/
│   │   └── intelligence/
│   ├── config/             # Configuration files
│   │   ├── complexity-rules.json
│   │   ├── agent-templates.json
│   │   └── learning-config.json
│   ├── memory/             # Your session data
│   │   ├── project-profile.md   # Project facts - POPULATE THIS for best results
│   │   ├── sessions.md
│   │   └── prompt-patterns.md
│   └── rules/              # Path-specific rules
├── CLAUDE.md               # Project instructions

Populate Your Project Profile

After installation, populate .claude/memory/project-profile.md with your project facts. Commands load this file automatically, so you never need to repeat your tech stack, preferences, or project structure.

The file has pre-made sections. Fill in what applies to your project.

Verify Installation

After installation, verify everything works:

powershell
# Check .claude directory exists
Test-Path ".claude"

# List installed commands
Get-ChildItem ".claude\commands"

Start Claude Code in your project:

powershell
claude

Then try a command:

bash
/prompt Hello, test installation

You should see Claude run the prompt through Phase 0 validation.

Updating

To update to the latest version:

powershell
.\install-claude-commands.ps1

The installer automatically:

  1. Detects existing installation
  2. Creates backup of current files
  3. Pulls latest from GitHub
  4. Preserves your memory files (sessions.md, project-profile.md, etc.)
  5. Adds new memory files from latest version without overwriting existing ones

Config Customizations

If you've customized config files, back them up before updating:

powershell
Copy-Item ".claude\config\complexity-rules.json" "my-complexity-rules.json"

Optional: Enhanced Statusline

Add real-time metrics to your terminal:

powershell
iwr -useb https://raw.githubusercontent.com/Tadzesi/claude-ideas/main/install-claude-statusline.ps1 | iex

This displays:

■ my-project | ⎇ main | ████████░░ 45% | ● 27k/155k | ▶ 89k/15k | ◆ 3.2s

Learn more about the statusline →

Troubleshooting

"Git is not recognized"

Install Git from git-scm.com, then restart PowerShell.

"Execution policy" error

powershell
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

"Access denied" error

  1. Close Claude Code if running
  2. Run PowerShell as Administrator
  3. Try installation again

Commands not appearing

  1. Verify .claude/commands/ exists
  2. Restart Claude Code
  3. Check CLAUDE.md is in project root

GitHub authentication failed

powershell
git config --global credential.helper wincred
git clone https://github.com/Tadzesi/claude-ideas.git

Enter your GitHub username and Personal Access Token when prompted.

Uninstallation

To completely remove:

powershell
# Remove .claude directory
Remove-Item -Path ".claude" -Recurse -Force

# Remove project files (optional)
Remove-Item "CLAUDE.md" -Force

# Remove backups (optional)
Remove-Item -Path ".claude-backup" -Recurse -Force

Next Steps

Installation complete! Continue with:

Released under the MIT License.