Installation

This guide will walk you through installing AgileFlow in your development environment.

Quick Installation

The fastest way to get started with AgileFlow is using the install command:

npx @xloxn69/agileflow install

What Gets Installed

The installation process will create the following structure in your project:

.agileflow/
├── config.json          # Main configuration
├── epics/              # Epic definitions
├── stories/            # User stories
└── .meta/              # Metadata and state

.claude/
├── commands/           # Custom slash commands
└── agents/             # Agent configurations

Installation Steps

npx @xloxn69/agileflow install

ls -la .agileflow/

Manual Installation

If you prefer to install manually:

1. Create directories:

   mkdir -p .agileflow/{epics,stories,.meta}
   mkdir -p .claude/{commands,agents}

2. Create config file: Create .agileflow/config.json:

   {
     "version": "1.0.0",
     "projectName": "My Project",
     "sprintDuration": 14,
     "velocityTracking": true
   }

3. Install commands: Copy command files to .claude/commands/

Verifying Installation

To verify that AgileFlow is installed correctly, try running:

/AgileFlow:help

You should see a list of available commands and agents.

Next Steps

After installation:

1. Complete the Quick Start tutorial
2. Read about Core Concepts
3. Explore the Commands Reference

Troubleshooting

Command not found

If commands aren't recognized:

• Ensure .agileflow/ is in your project root
• Restart your IDE
• Check file permissions

Configuration errors

If you see configuration errors:

• Verify config.json is valid JSON
• Check that all required fields are present
• Review the Configuration Guide

Uninstalling

To remove AgileFlow:

rm -rf .agileflow .claude