upload-git-issues

🚀 Upload Git Issues

Zero-config CLI to bulk upload CSV data to GitHub Issues

Perfect for platform migrations - create GitHub Issues from your CSV exports, then use Linear's native GitHub import to sync.

🚀 Quick Start

# One command - that's it!
npx upload-git-issues your-file.csv

# With options
npx upload-git-issues issues.csv --dry-run --verbose

What happens:

• Interactive prompts guide you through GitHub authentication and repo selection
• Intelligent CSV parsing (works with Linear exports, Jira exports, any CSV format)
• Beautiful progress indicators show real-time status
• Issues created in GitHub - ready for Linear's native GitHub import

📄 Sample CSV to Get Started

Create a file called issues.csv with this content:

Title,Description,Labels,Priority,Assignee
"Fix login authentication bug","Users are unable to log in with valid credentials","bug,urgent","High","johndoe"
"Add dark mode toggle","Implement dark/light theme switcher in user settings","enhancement,ui","Medium","janedoe"
"Update API documentation","Refresh the API docs with latest endpoint changes","documentation","Low","techwriter"
"Optimize database queries","Improve performance of user dashboard queries","performance,backend","High","dbadmin"

Then run:

npx upload-git-issues issues.csv --dry-run

🧪 Local Development & Testing

Note: This tool is currently in pre-release. For local testing and development:

Method 1: Development Mode (Fastest)

git clone https://github.com/rhyanvargas/upload-git-issues.git
cd upload-git-issues
npm install
npm run dev -- --help
npm run dev -- example.csv --dry-run

Method 2: Build and Test

npm run build
npm start -- --help
npm start -- example.csv --dry-run

Method 3: Global Installation Testing (Most Realistic)

# Link for global testing (does NOT publish live)
npm link

# Test as if installed globally
upload-git-issues --help
upload-git-issues example.csv --dry-run

# Unlink when done testing
npm unlink -g upload-git-issues

⚠️ Important: npm link is safe and local-only. It does NOT publish to npm registry.

💡 Tip: Use the included example.csv file for testing, or create your own following the CSV format shown in the Quick Start section above.

📋 When to Use This Tool

Your Situation	Use This Tool?	Why
🔄 Migrating to Linear via GitHub	✅ Perfect Choice	Create GitHub Issues, then use Linear's GitHub import
📊 Have CSV data to upload	✅ Perfect Choice	Intelligent parsing handles any CSV format
⚡ Need it done quickly	✅ Perfect Choice	One command, 2 minutes to complete
🏢 Enterprise/Security requirements	✅ Perfect Choice	Built-in security audits and compliance
👥 Non-technical team member	✅ Perfect Choice	Interactive prompts guide you through
🔒 Single repository upload	✅ Perfect Choice	Optimized for this common use case
🎯 Creating 5-1000+ issues	✅ Perfect Choice	Handles any volume with progress tracking
🏗️ Multi-repository bulk operations	⚠️ Consider Alternatives	Our tool focuses on single repositories
📝 Complex issue templating needs	⚠️ Consider Alternatives	Use tools with Mustache/Liquid support
🤖 GitHub Actions workflow integration	⚠️ Consider Alternatives	Look for native CI/CD solutions
💬 Adding comments to existing issues	⚠️ Consider Alternatives	Our tool creates new issues only
⚙️ Highly customized automation	⚠️ Consider Alternatives	Use scriptable solutions

📋 Options

Option	Description	Example
[csv-file]	Path to CSV file	./issues.csv
--dry-run	Preview without creating	--dry-run
--verbose	Detailed logging	--verbose
--token <token>	GitHub token (skip prompt)	--token ghp_abc123
--repo <repo>	Target repository	--repo owner/repo

📊 CSV Format

Required: Title column
Optional: Description, Labels, Assignee, Priority, Status, etc.

Title,Description,Labels,Assignee,Priority
"Fix login bug","Users cannot log in","bug,urgent","johndoe","High"
"Add dark mode","Implement dark theme","enhancement,ui","janedoe","Medium"

The tool intelligently maps column names (Title/title/TITLE all work) and converts Priority/Status to labels.

💡 Linear Migration Tip: After creating GitHub Issues, use Linear's native GitHub import feature to sync them into your Linear workspace.

🔑 GitHub Authentication

Create a Personal Access Token with repo scope. The tool will prompt you for it.

⚖️ Legal Disclaimer

IMPORTANT: By using this tool, you acknowledge that:

• YOU are solely responsible for ensuring the security and safety of your files
• YOU must verify that any CSV files do not contain sensitive or confidential information
• YOU are responsible for verifying the security of any tools you use
• YOU should review the source code and run security audits before use
• YOU must ensure proper authorization for GitHub API usage and repository access

This software is provided "AS IS" without warranties. See DISCLAIMER.md for complete legal terms.

🔒 Security Recommendation: Always review your CSV data and test with non-sensitive information first.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Made with ❤️ for developers who love automation