{"id":25480646,"url":"https://github.com/ljlm0402/auto-github-tool","last_synced_at":"2026-02-18T06:31:08.151Z","repository":{"id":276806351,"uuid":"929731488","full_name":"ljlm0402/auto-github-tool","owner":"ljlm0402","description":"🗃️ AGT(Automatic Git \u0026 GitHub Tool)","archived":false,"fork":false,"pushed_at":"2025-02-22T08:44:43.000Z","size":50,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-22T00:51:25.146Z","etag":null,"topics":["automatic","branch","git","github","issues","pull-request","tool"],"latest_commit_sha":null,"homepage":"http://npm.im/auto-github-tool","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ljlm0402.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-09T08:59:20.000Z","updated_at":"2025-10-17T00:42:01.000Z","dependencies_parsed_at":"2025-04-09T17:08:31.117Z","dependency_job_id":"4a6e248c-620d-47cd-954d-0f68f47337d5","html_url":"https://github.com/ljlm0402/auto-github-tool","commit_stats":null,"previous_names":["ljlm0402/auto-github-tool"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/ljlm0402/auto-github-tool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ljlm0402%2Fauto-github-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ljlm0402%2Fauto-github-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ljlm0402%2Fauto-github-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ljlm0402%2Fauto-github-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ljlm0402","download_url":"https://codeload.github.com/ljlm0402/auto-github-tool/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ljlm0402%2Fauto-github-tool/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29570327,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T06:19:27.422Z","status":"ssl_error","status_checked_at":"2026-02-18T06:18:44.348Z","response_time":162,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automatic","branch","git","github","issues","pull-request","tool"],"created_at":"2025-02-18T15:55:59.730Z","updated_at":"2026-02-18T06:31:08.136Z","avatar_url":"https://github.com/ljlm0402.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n\u003cbr\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/3ff372bb-9216-4537-81e9-59d91960b7ce\" width=\"600\" alt=\"Project Logo\" /\u003e\n  \u003cbr\u003e\n    \u003cbr\u003e\n  Auto GitHub Tool\n  \u003cbr\u003e\n\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003e🤖 A CLI tool to automate GitHub issue handling, branch creation, and PR submission.\u003c/h4\u003e\n\n\u003cp align =\"center\"\u003e\n  \u003ca href=\"https://nodei.co/npm/auto-github-tool\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://nodei.co/npm/auto-github-tool.png\" alt=\"npm Info\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"http://npm.im/auto-github-tool\" target=\"_blank\"\u003e\n      \u003cimg src=\"https://img.shields.io/npm/v/auto-github-tool.svg\" alt=\"npm Version\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"http://npm.im/auto-github-tool\" target=\"_blank\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/v/release/ljlm0402/auto-github-tool\" alt=\"npm Release Version\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"http://npm.im/auto-github-tool\" target=\"_blank\"\u003e\n      \u003cimg src=\"https://img.shields.io/npm/dm/auto-github-tool.svg\" alt=\"npm Downloads\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"http://npm.im/auto-github-tool\" target=\"_blank\"\u003e\n      \u003cimg src=\"https://img.shields.io/npm/l/auto-github-tool.svg\" alt=\"npm Package License\" /\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/ljlm0402/auto-github-tool/stargazers\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/ljlm0402/auto-github-tool\" alt=\"github Stars\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/ljlm0402/auto-github-tool/network/members\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/forks/ljlm0402/auto-github-tool\" alt=\"github Forks\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/ljlm0402/auto-github-tool/stargazers\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/contributors/ljlm0402/auto-github-tool\" alt=\"github Contributors\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/ljlm0402/auto-github-tool/issues\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues/ljlm0402/auto-github-tool\" alt=\"github Issues\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003e· English \u003ca href=\"./README.ko.md\"\u003e· Korean\u003c/a\u003e\u003c/strong\u003e\n\u003c/p\u003e\n\n---\n\n## Introduction\n\nAGT (Auto GitHub Tool) is a CLI tool that automates branch management and pull request creation based on GitHub Issues, improving developer productivity and maintaining consistency in branch management.\n\n### ✨ Key Features\n\n- **🎯 Interactive Menu Mode**: Easy access to all features through an intuitive menu\n- **📋 Issue Management**: View issue lists and create issues using templates\n- **🌿 Branch Automation**: Automatically create issue-based branches (feature/bugfix/hotfix/release)\n- **🔀 PR Creation**: Automatically create pull requests using templates\n- **🏷️ Label Management**: Create and manage GitHub labels\n- **⚙️ Configuration File**: Support for project-specific or global settings (.agtrc.json)\n- **🪄 Setup Wizard**: Interactive 5-step setup wizard for easy first-time configuration\n- **🎨 Enhanced UX**: Better user experience with colored output, spinners, and input validation\n- **📊 Logging System**: Comprehensive logging to `~/.agt/agt.log` for debugging and tracking\n- **⚡ Smart Caching**: Automatic caching of GitHub API responses for improved performance\n- **🔄 Error Recovery**: Unified error handling system with automatic retry mechanism\n- **✅ Input Validation**: Multi-layer security validation to prevent shell injection\n- **📈 Performance**: Parallel API operations for 50-75% faster command execution\n\n## 📋 Table of Contents\n\n- [Requirements](#-requirements)\n- [Installation](#-installation)\n- [Quick Start](#-quick-start)\n- [Usage](#-usage)\n  - [Interactive Mode](#interactive-mode-recommended)\n  - [Direct Commands](#direct-commands)\n  - [Configuration File](#configuration-file)\n- [Command Guide](#-command-guide)\n  - [Setup Wizard](#1-setup-wizard)\n  - [Help](#2-help)\n  - [List Issues](#3-list-issues)\n  - [Create Issue](#4-create-issue)\n  - [Create Branch](#5-create-branch)\n  - [Create Pull Request](#6-create-pull-request)\n  - [Create Label](#7-create-label)\n  - [Statistics](#8-statistics)\n- [Project Structure](#-project-structure)\n- [Developer Guide](#-developer-guide)\n- [Troubleshooting](#-troubleshooting)\n- [Contributing](#-contributing)\n- [License](#-license)\n\n## 📌 Requirements\n\n- Node.js 14 or higher\n- GitHub CLI (gh) installation required\n- GitHub account\n\n```sh\nnode -v # Check version\ngh --version  # Check installation\n```\n\n## 🚀 Installation\n\n1. **Install GitHub CLI**\n\n   ```bash\n   # Install via Homebrew (macOS)\n   brew install gh\n\n   # Other platforms: https://cli.github.com/\n   ```\n\n2. **Authenticate GitHub Account**\n\n   ```bash\n   gh auth login\n   ```\n\n   Follow the prompts:\n\n   1. `? What account do you want to log into?` → Select `GitHub.com`\n   2. `? What is your preferred protocol for Git operations?` → Select `HTTPS`\n   3. `? Authenticate Git with your GitHub credentials?` → Select `Yes`\n   4. `? How would you like to authenticate GitHub CLI?` → Select `Login with a web browser`\n   5. Copy the one-time code displayed\n   6. Log in to GitHub in the automatically opened browser\n   7. Enter the copied code to complete authentication\n\n3. **Install AGT**\n\n   ```bash\n   npm install -g auto-github-tool\n   ```\n\n   After installation, you can use the `agt` command.\n\n## 🚀 Quick Start\n\nThe easiest way to get started with AGT is using the setup wizard:\n\n```bash\n$ agt setup\n\n╔════════════════════════════════════════════════╗\n║          🚀 AGT Setup Wizard                  ║\n╚════════════════════════════════════════════════╝\n\nThis wizard will help you configure AGT for the first time.\nIt will check your environment and guide you through the setup.\n\n✅ Step 1: Checking Git Installation\n   ✓ Git is installed (version 2.39.0)\n\n✅ Step 2: Checking GitHub CLI Installation\n   ✓ GitHub CLI is installed (version 2.40.0)\n\n✅ Step 3: Verifying GitHub Authentication\n   ✓ Authenticated as yourusername\n\n✅ Step 4: Testing GitHub Connection\n   ✓ Successfully connected to GitHub API\n\n⚙️  Step 5: AGT Configuration (Optional)\n   ? Where would you like to store the configuration?\n   ❯ 📁 Local (current project only)\n     🌍 Global (all projects)\n     ⏭️  Skip for now\n\n╔════════════════════════════════════════════════╗\n║            Setup Summary                      ║\n╚════════════════════════════════════════════════╝\n\n✅ PASS  Git installation\n✅ PASS  GitHub CLI installation\n✅ PASS  GitHub authentication\n✅ PASS  GitHub connection\n⏭️  SKIP  AGT configuration\n\n🎉 Setup completed successfully!\n\nYou're ready to use Auto GitHub Tool!\n\nQuick Start:\n  • Run 'agt' to start interactive mode\n  • Run 'agt help' to see all commands\n  • Run 'agt list' to view open issues\n```\n\n## 🛠 Usage\n\n### Interactive Mode (Recommended)\n\nThe easiest way to use AGT. Simply type `agt` without any command to display the interactive menu:\n\n```bash\n$ agt\n\n╔════════════════════════════════════════╗\n║   🤖 Auto GitHub Tool - Main Menu    ║\n╚════════════════════════════════════════╝\n\n? What would you like to do? (Use arrow keys)\n❯ 📋 List open issues\n  ➕ Create a new issue\n  🌿 Create a branch from an issue\n  🔀 Create a pull request\n  🏷️  Create a new label\n  ─────────────\n  ⚙️  Configure AGT settings\n  ❓ Show help\n  ─────────────\n  🚪 Exit\n```\n\n### Direct Commands\n\nYou can directly execute specific tasks by entering commands:\n\n```bash\nagt help      # Show available commands\nagt setup     # Run setup wizard (first-time users)\nagt list      # View open issues\nagt issue     # Create a new issue\nagt branch    # Create a branch from an issue\nagt pr        # Create a PR from current branch\nagt label     # Create a label\nagt stats     # Show repository statistics\nagt config    # Initialize configuration\n```\n\n### Configuration File\n\nAGT supports project-specific or global configuration.\n\n#### Initialize Configuration\n\n```bash\n# Local project configuration (.agtrc.json)\n$ agt config\n\n# Global configuration (~/.agtrc.json)\n$ agt config --global\n```\n\n#### Configuration File Example (.agtrc.json)\n\nThe project includes a `.agtrc.example.json` file. Copy it to use:\n\n```bash\ncp .agtrc.example.json .agtrc.json\n```\n\n```json\n{\n  \"defaultBaseBranch\": \"main\",\n  \"branchTypes\": [\n    { \"id\": \"1\", \"name\": \"feature\", \"description\": \"Develop new features\" },\n    { \"id\": \"2\", \"name\": \"bugfix\", \"description\": \"Fix bugs\" },\n    { \"id\": \"3\", \"name\": \"hotfix\", \"description\": \"Urgent fixes\" },\n    { \"id\": \"4\", \"name\": \"release\", \"description\": \"Prepare for a release\" }\n  ],\n  \"autoAssign\": true,\n  \"defaultLabels\": [],\n  \"autoTemplates\": true\n}\n```\n\n**Configuration Options:**\n\n- `defaultBaseBranch`: Default base branch when creating PRs\n- `branchTypes`: Define branch types\n- `autoAssign`: Automatically assign yourself\n- `defaultLabels`: Default labels to apply\n- `autoTemplates`: Automatically use templates\n\n## 📚 Command Guide\n\n### 1. Setup Wizard\n\nInteractive setup wizard to help you configure AGT for the first time.\n\n```bash\n$ agt setup\n\n╔════════════════════════════════════════════════╗\n║          🚀 AGT Setup Wizard                  ║\n╚════════════════════════════════════════════════╝\n\nThis wizard will check:\n  ✓ Git installation\n  ✓ GitHub CLI installation\n  ✓ GitHub authentication\n  ✓ GitHub connection\n  ⚙️  AGT configuration (optional)\n\nRun this command when:\n  • First time using AGT\n  • After reinstalling dependencies\n  • Having authentication issues\n  • Want to reconfigure AGT\n```\n\n**What it does:**\n\n1. **Git Check**: Verifies Git is installed and accessible\n2. **GitHub CLI Check**: Verifies GitHub CLI (gh) is installed\n3. **Authentication**: Checks if you're authenticated with GitHub\n4. **Connection Test**: Tests GitHub API connectivity\n5. **Configuration**: Optionally create local or global config (can be skipped)\n\n**Features:**\n\n- ✅ Sequential validation with helpful error messages\n- 🔄 Interactive recovery options for failed steps\n- ⏭️ Skip configuration if you prefer default settings\n- 📊 Detailed summary at the end\n\n### 2. Help\n\n```bash\n$ agt help\n\n╔════════════════════════════════════════╗\n║        AGT Command Reference          ║\n╚════════════════════════════════════════╝\n\nUsage:\n  agt [command]\n\nCommands:\n  (no command)    Start interactive menu\n  setup           Run setup wizard (recommended for first-time users)\n  help            Show this help message\n  list            Show open issues\n  issue           Create a new issue\n  branch          Create a branch from an issue\n  pr              Create a pull request\n  label           Create a new label\n  stats           Show repository statistics\n  config          Configure AGT settings\n\nConfiguration Files:\n  .agtrc.json     Project-specific settings\n  ~/.agtrc.json   User-wide settings\n\nQuick Start:\n  $ agt                # Interactive mode (recommended for beginners)\n  $ agt setup          # First-time setup wizard\n  $ agt list           # View open issues\n  $ agt config         # Initialize configuration\n```\n\n### 3. List Issues\n\nView all open issues in the current repository.\n\n```bash\n$ agt list\n\n=== 📋 Open Issues ===\n\n123 Fix login bug [bug]\n124 Add dark mode feature [enhancement]\n125 Update documentation [documentation]\n```\n\n### 4. Create Issue\n\nCreate issues using templates.\n\n```bash\n$ agt issue\n\n📍 Enter issue title: Fix login authentication issue\n\n📌 Available Issue Templates:\n1. bug_report.md\n2. feature_request.md\n3. question.md\nSelect a template number or press Enter to skip: 1\n\n🐞 Describe the bug clearly: Users cannot login with valid credentials\n✅ What did you expect to happen?: Successful login\n...\n\n👥 Enter assignees (comma-separated, or press Enter to skip):\n✓ Assignee set to your account: yourusername\n\n=== 📋 Available Labels ===\n[1] bug\n[2] enhancement\n[3] documentation\n...\n🏷 Select labels [1...9 / a, b, c]: 1\n\n🏷️ Selected Labels: bug\n\n📅 Enter milestone (or press Enter to skip): v1.0\n\n⠋ Creating GitHub issue...\n✅ GitHub issue created successfully.\n```\n\n### 5. Create Branch\n\nAutomatically create a branch by selecting an issue number.\n\n**Branch Naming Convention:** `{type}/{issue-number}-{sanitized-title}`\n\n```bash\n$ agt branch\n\n=== 📋 Open Issues ===\n\n123 Fix login bug [bug]\n124 Add dark mode feature [enhancement]\n\n🔢 Enter issue number to create branch: 123\n\n📌 Select a branch type:\n[1] feature - Develop new features\n[2] bugfix - Fix bugs\n[3] hotfix - Urgent fixes\n[4] release - Prepare for a release\n\n🔢 Enter the branch type number: 2\n\n⠋ Creating branch 'bugfix/123-fix-login-bug'...\n✅ Branch 'bugfix/123-fix-login-bug' has been successfully created.\n```\n\n### 6. Create Pull Request\n\nAutomatically create a PR from the current branch. Supports templates and can automatically link related issues.\n\n```bash\n$ agt pr\n\n📍 Enter PR title: Fix login authentication bug\n\n📌 Provide a short summary of your changes: Fixed session validation logic\n\n=== 📋 Open Issues ===\n123 Fix login bug [bug]\n\n🔍 Enter the related issue number (e.g., #27): 123\n✨ Describe the major changes in your PR: Updated auth middleware\n✅ Have you tested the changes locally? (yes/no): yes\n📏 Does your code follow the project's style guidelines? (yes/no): yes\n📖 Have you updated the documentation if necessary? (yes/no): yes\n🔗 Add any additional information (optional):\n\n👀 Enter reviewers (comma-separated, or press Enter to skip):\n👥 Enter assignees (comma-separated, or press Enter to skip):\n✓ Assignee set to your account: yourusername\n\n=== 📋 Available Labels ===\n[1] bug\n[2] enhancement\n🏷 Select labels [1...9 / a, b, c]: 1\n\n🏷️ Selected Labels: bug\n\n📅 Enter milestone (or press Enter to skip): v1.0\n\n🌿 Available branches:\n[1] main (default)\n[2] development\nSelect base branch (or press Enter for 'main'):\n\nCurrent branch: bugfix/123-fix-login-bug\nFound 3 commit(s) to push.\n\n⠋ Pushing branch 'bugfix/123-fix-login-bug' to remote...\n✅ Branch 'bugfix/123-fix-login-bug' pushed successfully.\n⠋ Creating pull request...\n✅ Pull request created successfully.\n```\n\n### 7. Create Label\n\nCreate a new label in the GitHub repository.\n\n```bash\n$ agt label\n\n🏷 Enter label name: urgent\n🎨 Enter label color (6-digit hex, e.g., FFFFFF) [default: FFFFFF]: FF0000\n📝 Enter label description (optional): Urgent issues that need immediate attention\n\n⠋ Creating label 'urgent'...\n✅ Label 'urgent' has been successfully created.\n```\n\n### 8. Statistics\n\nDisplay comprehensive repository statistics and insights.\n\n```bash\n$ agt stats\n\n╔════════════════════════════════════════════════╗\n║       📊 Repository Statistics                ║\n╚════════════════════════════════════════════════╝\n\nRepository: ljlm0402/auto-github-tool\n\n📈 Overview\n  ⭐ Stars:          42\n  🍴 Forks:          8\n  👁️  Watchers:       5\n  🐛 Open Issues:    3\n  🔓 Open PRs:       1\n\n👥 Contributors\n  Total contributors: 5\n\n  Top Contributors:\n  • ljlm0402         (245 commits)\n  • contributor2     (38 commits)\n  • contributor3     (12 commits)\n\n🏷️  Most Used Labels\n  • bug              (12 issues)\n  • enhancement      (8 issues)\n  • documentation    (5 issues)\n\n📊 Issue Statistics\n  • Total Issues:    45\n  • Open:            3\n  • Closed:          42\n  • Close Rate:      93.3%\n\n🔀 PR Statistics\n  • Total PRs:       38\n  • Open:            1\n  • Merged:          35\n  • Closed:          2\n  • Merge Rate:      94.6%\n```\n\n**Features:**\n\n- ⚡ **Fast Performance**: Parallel API calls (50-75% faster)\n- 📊 **Comprehensive Data**: Stars, forks, issues, PRs, contributors\n- 🎯 **Smart Caching**: Results cached for 5 minutes\n- 🎨 **Beautiful Output**: Colored and formatted display\n\n### Contributing to the Project\n\n1. **Create an issue**\n\n   ```bash\n   agt issue\n   ```\n\n2. **Create a branch**\n\n   ```bash\n   agt branch\n   ```\n\n3. **Make changes and commit**\n\n   ```bash\n   git add .\n   git commit -m \"feat: Add new feature\"\n   ```\n\n4. **Create a PR**\n   ```bash\n   agt pr\n   ```\n\n## 👀 Debug Mode\n\nAGT includes a comprehensive debug mode for troubleshooting issues. When enabled, it shows detailed logs in the console and records them to `~/.agt/agt.log`.\n\n### Enable Debug Mode\n\n```bash\n# Set environment variable\nAGT_DEBUG=true agt branch\n\n# Or use the --debug flag\nagt branch --debug\n```\n\n### View Logs\n\n```bash\n# View log file location\nls ~/.agt/\n\n# Tail logs in real-time\ntail -f ~/.agt/agt.log\n\n# Search logs (macOS/Linux)\ngrep \"ERROR\" ~/.agt/agt.log\n```\n\n### Log Levels\n\n- **INFO**: General information about operations\n- **DEBUG**: Detailed debugging information\n- **WARN**: Warning messages\n- **ERROR**: Error messages with stack traces\n\n## 🔍 Troubleshooting\n\n### ❌ Common Errors\n\n1. **Not a Git repository**\n\n   ```\n   ❌ This is not a Git repository. Please run 'git init' first.\n   ```\n\n   ➡️ Solution: Initialize Git repository with `git init`\n\n2. **GitHub CLI authentication error**\n\n   ```\n   ❌ GitHub authentication failed. Please run 'gh auth login' first.\n   ```\n\n   ➡️ Solution: Re-authenticate with `gh auth login` or run `agt setup`\n\n3. **GitHub CLI not installed**\n\n   ```\n   ❌ GitHub CLI is not installed. Please install it: https://cli.github.com/\n   ```\n\n   ➡️ Solution: Install with `brew install gh` (macOS) or from the official website\n\n4. **Network errors**\n\n   ```\n   ❌ Network error: Please check your internet connection and try again.\n   ```\n\n   ➡️ Solution: AGT automatically retries network operations up to 3 times. If the error persists, check your internet connection\n\n5. **Branch does not exist**\n\n   ```\n   ❌ Source branch 'feature/123-...' does not exist\n   ```\n\n   ➡️ Solution: Create the branch first with `agt branch`\n\n6. **No commits**\n\n   ```\n   ❌ No commits found between 'main' and 'feature/123-...'.\n   Please commit your changes before creating a PR.\n   ```\n\n   ➡️ Solution: Commit your changes before creating a PR\n\n7. **Invalid branch name**\n   ```\n   ❌ Invalid branch name: Branch names cannot contain shell special characters\n   ```\n   ➡️ Solution: AGT automatically sanitizes branch names. If you see this error, the issue title may contain forbidden characters\n\n### 🆘 Getting Help\n\nIf you're still experiencing issues:\n\n1. **Run setup wizard**: `agt setup` to verify your environment\n2. **Enable debug mode**: `AGT_DEBUG=true agt \u003ccommand\u003e` for detailed logs\n3. **Check logs**: View `~/.agt/agt.log` for error details\n4. **Report issue**: Create an issue on GitHub with the error message and logs\n\n## 🤝 Contributing\n\nContributions are always welcome! Please feel free to open an issue or submit a pull request.\n\n## 💳 License\n\n[MIT](LICENSE)\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made with ❤️ by \u003ca href=\"https://github.com/ljlm0402\"\u003eAGUMON\u003c/a\u003e 🦖\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fljlm0402%2Fauto-github-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fljlm0402%2Fauto-github-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fljlm0402%2Fauto-github-tool/lists"}