den-github-manager 1.0.0 → 1.0.2

package/README.md

@@ -3,7 +3,9 @@
 > Automate your GitHub Projects setup in minutes. Analyze projects, generate backlogs, and configure milestones, issues, and project boards - all from the command line.
 
 [![npm version](https://img.shields.io/npm/v/den-github-manager.svg)](https://www.npmjs.com/package/den-github-manager)
+[![npm downloads](https://img.shields.io/npm/dm/den-github-manager.svg)](https://www.npmjs.com/package/den-github-manager)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![GitHub stars](https://img.shields.io/github/stars/wolfcito/den-github-manager.svg)](https://github.com/wolfcito/den-github-manager)
 
 ## ✨ Features
 
@@ -13,6 +15,7 @@
 - 🚀 **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
 
@@ -32,12 +35,25 @@ npx den-github-manager init
 # Navigate to your project
 cd my-project
 
-# Initialize GitHub project setup
+# Interactive mode (asks questions)
 den init
 
-# That's it! Follow the interactive prompts
+# 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](docs/ai-agent-usage.md) for complete documentation.
+
 ## 📖 Usage
 
 ### Initialize Project Setup

package/bin/den.js

@@ -2,15 +2,24 @@
 
 import { program } from 'commander';
 import chalk from 'chalk';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
 import { initCommand } from '../src/commands/init.js';
 import { analyzeCommand } from '../src/commands/analyze.js';
 import { templatesCommand } from '../src/commands/templates.js';
 import { configCommand } from '../src/commands/config.js';
 
+// Read version from package.json
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJson = JSON.parse(
+  readFileSync(join(__dirname, '../package.json'), 'utf-8')
+);
+
 const pkg = {
-  name: 'den-github-manager',
-  version: '1.0.0',
-  description: 'CLI tool to setup GitHub Projects automatically'
+  name: packageJson.name,
+  version: packageJson.version,
+  description: packageJson.description
 };
 
 console.log(chalk.blue.bold(`\n🦁 ${pkg.name} v${pkg.version}`));

package/docs/ai-agent-usage.md

@@ -0,0 +1,243 @@
+# 🤖 Using Den with AI Agents
+
+Den GitHub Manager is designed to work seamlessly with AI coding agents like Claude, ChatGPT, Cursor, and others.
+
+## Problem
+
+By default, `den init` is interactive - it asks questions that AI agents cannot answer.
+
+## Solution
+
+Use **AI-friendly modes** that are completely non-interactive:
+
+## 🎯 Recommended Commands for AI Agents
+
+### Option 1: Auto Mode (Recommended)
+
+```bash
+# Non-interactive setup with defaults
+den init --auto
+
+# With specific template
+den init --template startup --auto
+
+# With dry-run to preview
+den init --template agile --auto --dry-run
+```
+
+### Option 2: Step-by-step
+
+```bash
+# 1. Analyze first
+den analyze --json
+
+# 2. Based on analysis, init with template
+den init --template simple --auto
+```
+
+## 📋 Prompt Templates for AI Agents
+
+### For New Projects
+
+```
+Before we start coding, set up project management:
+
+1. Run: den analyze --json
+2. Run: den init --template startup --auto
+3. Show me the summary
+
+This will create milestones, issues, and labels automatically.
+```
+
+### For Existing Projects
+
+```
+Set up GitHub project management:
+
+1. Run: den analyze
+2. If backlog exists: den init --auto
+3. If no backlog: den init --template agile --auto
+
+Then show me what was created.
+```
+
+### For Claude Code / Cursor
+
+```
+Execute this command and tell me the results:
+
+den init --template startup --auto --dry-run
+
+If everything looks good, run without --dry-run
+```
+
+## 🎨 Template Selection Guide for AI
+
+| Project Type | Recommended Template | Command |
+|--------------|---------------------|---------|
+| Side project | `simple` | `den init --template simple --auto` |
+| Startup/MVP | `startup` | `den init --template startup --auto` |
+| Team project | `agile` | `den init --template agile --auto` |
+| Enterprise | `enterprise` | `den init --template enterprise --auto` |
+
+## 📊 JSON Output for Parsing
+
+```bash
+# Get analysis as JSON for programmatic use
+den analyze --json
+
+# Example output:
+{
+  "projectName": "my-app",
+  "projectType": "nodejs",
+  "phase": "development",
+  "techStack": ["React", "Next.js"],
+  "hasBacklog": { "exists": true, "path": "docs/backlog.md" },
+  "recommendations": [...]
+}
+```
+
+## 🔄 Complete AI Agent Workflow
+
+### Example Conversation with Claude Code
+
+**Human:** "Set up GitHub project management for this repository"
+
+**AI Agent executes:**
+
+```bash
+# Step 1: Analyze
+den analyze
+
+# Step 2: Initialize (non-interactive)
+den init --template startup --auto
+
+# Step 3: Verify
+ls docs/backlog.md
+cat docs/backlog.md | head -50
+```
+
+**AI Agent reports:** "✅ Created 4 milestones, 28 issues, and complete backlog"
+
+## ⚙️ Configuration for AI Agents
+
+Set defaults to avoid flags:
+
+```bash
+# Set default template
+den config --set defaultTemplate=startup
+
+# Set auto mode as default
+den config --set autoMode=true
+
+# Now AI can just run:
+den init
+```
+
+## 🎯 Best Practices
+
+### ✅ DO
+
+- Use `--auto` flag for non-interactive execution
+- Use `--dry-run` first to preview changes
+- Use `--json` for programmatic parsing
+- Specify `--template` explicitly
+
+### ❌ DON'T
+
+- Run `den init` without `--auto` in AI context
+- Forget to check if `gh` CLI is authenticated
+- Run without analyzing first (`den analyze`)
+
+## 🐛 Troubleshooting
+
+### "Waiting for user input"
+
+```bash
+# This will hang:
+den init
+
+# Use this instead:
+den init --auto
+```
+
+### "GitHub authentication required"
+
+```bash
+# AI agent should check first:
+gh auth status
+
+# If not authenticated:
+gh auth login
+```
+
+### "No template selected"
+
+```bash
+# Always specify template in auto mode:
+den init --template simple --auto
+```
+
+## 📝 Example Prompts
+
+### For Claude Code
+
+```
+Please set up GitHub Projects for this repository:
+
+1. First run: `den analyze` to understand the project
+2. Then run: `den init --template startup --auto`
+3. Show me what milestones and issues were created
+
+Use the startup template since this is an MVP.
+```
+
+### For Cursor
+
+```
+Configure project management:
+
+```bash
+den init --template agile --auto --dry-run
+```
+
+Review the output, then execute without --dry-run
+```
+
+### For ChatGPT Code Interpreter
+
+```
+Execute this command sequence:
+
+```bash
+cd /project
+den analyze --json
+den init --template simple --auto
+```
+
+Parse the JSON output and summarize what was created.
+```
+
+## 🚀 Advanced: Custom AI Prompts
+
+### Create a custom den command via AI
+
+```
+Based on my project analysis, suggest the best den command:
+
+Project type: [nodejs/python/go]
+Team size: [solo/small/large]
+Methodology: [agile/kanban/waterfall]
+
+Then execute the suggested command with --auto flag.
+```
+
+## 📚 See Also
+
+- [Configuration Guide](configuration.md)
+- [Templates Guide](templates.md)
+- [CLI Reference](usage.md)
+
+---
+
+**Made for AI agents by AI agents** 🤖❤️🦁

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "den-github-manager",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "CLI tool to setup GitHub Projects automatically - Analyze, generate backlog, and configure milestones, issues, and project boards in minutes",
   "main": "src/index.js",
   "type": "module",