🦁 Den GitHub Manager

Automate your GitHub Projects setup in minutes. Analyze projects, generate backlogs, and configure milestones, issues, and project boards - all from the command line.

✨ Features

• 🔍 Smart Analysis - Automatically analyzes your project structure
• 📋 Auto-Generate Backlog - Creates backlog from your codebase if none exists
• 🎨 Multiple Templates - Simple, Startup MVP, Agile, Enterprise
• 🚀 One Command Setup - Configure everything in minutes
• 💾 Reusable - Works with any project, new or existing
• 🤖 GitHub Integration - Creates milestones, issues, labels automatically
• 🦾 AI Agent Friendly - Non-interactive mode for Claude, ChatGPT, Cursor

🚀 Quick Start

Install

# Global installation
npm install -g den-github-manager

# Or use with npx (no installation needed)
npx den-github-manager init

Basic Usage

# Navigate to your project
cd my-project

# Interactive mode (asks questions)
den init

# Non-interactive mode (perfect for AI agents)
den init --template startup --auto

🤖 Using with AI Agents (Claude, ChatGPT, Cursor)

Perfect for AI coding assistants! Tell your AI agent:

Run: den init --template startup --auto

This will set up GitHub Projects without any prompts.

See AI Agent Usage Guide for complete documentation.

📖 Usage

Initialize Project Setup

# Interactive mode (recommended for first time)
den init

# Use specific template
den init --template startup

# Auto mode (no prompts, use defaults)
den init --auto

# Dry run (see what would be done)
den init --dry-run

Analyze Project

# Get detailed project analysis
den analyze

# Output as JSON
den analyze --json

List Templates

# See available templates
den templates --list

# Show template details
den templates --show startup

Configuration

# List all configuration
den config --list

# Set config value
den config --set defaultTemplate=agile

# Get config value
den config --get defaultTemplate

🎨 Templates

📦 Simple

• Best for: Personal projects, side projects
• Milestones: 3 (Foundation, Core, Polish)
• Issues: ~10
• Duration: Flexible

🚀 Startup MVP

• Best for: Startups, product development
• Milestones: 4 (Foundation, MVP Core, User Testing, Production)
• Issues: ~30
• Duration: 2-3 months

🏃 Agile/Scrum

• Best for: Teams using Agile/Scrum
• Milestones: Sprint-based (recurring)
• Issues: ~50
• Duration: 2-week sprints

🏢 Enterprise

• Best for: Large organizations, complex projects
• Milestones: 5+ phases (Discovery, Design, Development, Testing, Deployment)
• Issues: 50+
• Duration: 6+ months

📊 What Gets Created

When you run den init, it creates:

Milestones

• Organized phases/sprints with descriptions
• Properly configured (open/closed based on completion)

Labels

• Priority: P0:Critical, P1:High, P2:Medium
• Status: in-progress, completed
• Story Points: 3, 5, 8
• Epics: Custom based on your project

Issues

• Structured user stories
• Acceptance criteria
• Labels and milestones assigned
• Story points estimated

Documentation

• docs/backlog.md - Complete backlog
• .den-config.json - Project configuration

🔧 Requirements

• Node.js >= 18.0.0
• GitHub CLI (gh) installed and authenticated
• Git repository initialized

Setup GitHub CLI

# Install gh CLI
brew install gh  # macOS
# or visit: https://cli.github.com/

# Authenticate
gh auth login

💡 Examples

New Project

$ cd my-new-app
$ den init

🦁 Den GitHub Manager - Project Setup

🔍 Analyzing project...
✓ Project analyzed

❌ No backlog found

? How would you like to proceed?
  ❯ 📋 Use a template (recommended)
    🤖 Generate from project structure
    ✍️  Create manually later

? Select a template:
  ❯ 🚀 Startup MVP (4 milestones, ~30 issues)

✓ Backlog generated
✓ GitHub client ready
✓ Created 4 milestones
✓ Labels created
✓ Created 28 issues

✅ Setup Complete!

📊 View: https://github.com/user/my-new-app/milestones

Existing Project with Backlog

$ cd existing-project
$ den init

🦁 Den GitHub Manager - Project Setup

🔍 Analyzing project...
✓ Found backlog: docs/backlog.md
✓ Detected structure:
  - 4 milestones
  - 32 user stories

? Proceed with this structure? Yes

✓ Created 4 milestones
✓ Labels created
✓ Created 32 issues

✅ Setup Complete!

🎯 Use Cases

| Project Type | Recommended Template | Setup Time | |--------------|---------------------|------------| | Personal side project | Simple | 2 min | | Startup MVP | Startup | 3 min | | Team project (Agile) | Agile | 5 min | | Enterprise application | Enterprise | 10 min | | Open source library | Simple/Agile | 3 min |

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details.

# Clone repository
git clone https://github.com/wolfcito/den-github-manager.git
cd den-github-manager

# Install dependencies
npm install

# Run locally
npm start -- init

# Run tests
npm test

# Lint code
npm run lint

📚 Documentation

• Installation Guide
• Usage Guide
• Templates Guide
• Configuration
• API Reference

🐛 Troubleshooting

GitHub CLI not authenticated

gh auth login

Permission denied

Make sure gh CLI has necessary scopes:

gh auth refresh -s project,repo

Template not found

List available templates:

den templates --list

🗺️ Roadmap

• [x] v1.0 - Core functionality
• [ ] v1.1 - Project board auto-creation
• [ ] v1.2 - AI-powered backlog generation
• [ ] v1.3 - Multi-repo support
• [ ] v2.0 - Web UI

📄 License

MIT © wolfcito

🙏 Acknowledgments

Built with:

• Commander.js - CLI framework
• Inquirer.js - Interactive prompts
• Chalk - Terminal styling
• Octokit - GitHub API client

🌟 Star History

If this tool helps you, consider giving it a star! ⭐

📞 Support

• 🐛 Report a bug
• 💡 Request a feature
• 💬 Discussions

Made with ❤️ by wolfcito