{"_rev":"32-060db9392c0afe38cb62e071ef83327e","time":{"created":"2025-07-04T00:17:42.461Z","modified":"2025-07-04T00:17:42.911Z","1.0.0":"2024-08-08T05:08:04.469Z","1.0.1":"2024-08-08T05:18:28.810Z","1.0.2":"2024-08-11T23:25:10.417Z","1.0.3":"2024-11-27T06:05:53.587Z","1.2.0":"2024-12-18T01:00:15.876Z","1.2.1":"2024-12-29T23:24:12.722Z","1.4.0":"2024-12-30T00:29:37.106Z","1.4.1":"2024-12-30T00:37:23.852Z","1.4.2":"2024-12-30T00:49:58.680Z","1.4.3":"2024-12-30T02:03:40.775Z","1.4.4":"2025-01-15T02:27:16.565Z","1.5.0":"2025-01-26T14:48:02.164Z","1.5.2":"2025-01-26T16:06:58.882Z","1.5.3":"2025-01-26T17:24:08.317Z","1.6.0":"2025-01-27T03:36:42.428Z","1.6.1":"2025-01-27T03:43:11.609Z","1.6.2":"2025-01-28T09:19:59.237Z","1.6.3":"2025-01-28T09:24:10.575Z","1.6.4":"2025-01-28T09:39:29.584Z","1.6.5":"2025-01-28T09:50:16.856Z","1.6.6":"2025-01-28T12:16:52.471Z","1.6.7":"2025-02-03T01:02:45.035Z","1.6.8":"2025-02-03T05:13:32.352Z","1.7.0":"2025-02-13T02:20:17.607Z","1.7.1":"2025-03-12T08:48:01.045Z","1.7.2":"2025-04-02T00:59:33.495Z","1.7.3":"2025-04-27T07:09:46.433Z","1.8.0":"2025-05-22T02:08:51.562Z","1.8.2":"2025-05-22T04:13:27.820Z","1.8.4":"2025-05-26T01:30:48.188Z","1.8.6":"2025-07-04T00:17:42.640Z"},"_id":"gitip","name":"gitip","dist-tags":{"latest":"1.8.6"},"versions":{"1.8.6":{"name":"gitip","version":"1.8.6","description":"Automatically generate Git issues and pull requests for your workflow","main":"index.js","scripts":{},"bin":{"gitip":"index.js"},"keywords":["git","issue","pull request","automated git","github issues","github pull requests","workflow automation","git automation","issue generator","PR generator","github tools","collaboration","team collaboration","version control","git workflow","git convention","commit convention","coding convention"],"homepage":"https://github.com/chltjdrhd777/gitip","bugs":{"email":"chltjdrhd7777777@gmail.com"},"author":{"name":"devAnderson","email":"chltjdrhd777@gmail.com"},"license":"MIT","devDependencies":{},"dependencies":{"@inquirer/prompts":"^5.0.5","@inquirer/select":"^2.3.3","@opentf/cli-pbar":"^0.7.2","cli-progress":"^3.12.0","cli-spinners":"^3.0.0","commander":"^12.1.0","dotenv":"^16.4.5","enquirer":"^2.4.1","node-fetch":"^3.3.2","ora-classic":"^5.4.2","tsc-alias":"^1.8.8"},"_id":"gitip@1.8.6","gitHead":"77eec5aa4b324483bdb6246c3bc6263a4ba54eff","types":"./index.d.ts","_nodeVersion":"22.17.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-Z/NE1I7Vg0GaHNU6OEJAJa+UcZnjx82IX4/bIj4KN/0AFQAmxZj/KT3Yv2NGbgISi3NvWNYdmfwWcGzeEf8z5w==","shasum":"1d8ef3bed4829c6e827db9b5f548a34ea9424b4e","tarball":"https://registry.npmjs.org/gitip/-/gitip-1.8.6.tgz","fileCount":158,"unpackedSize":146028,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDklBSUR8HjY3rzVHB6Qr/xK+DDGn+C/t8IAt6OplJPrwIgNGccCJbAXru+ViKamH6ow6WJbiKCfKNkuRjfsnIEMh8="}]},"_npmUser":{"name":"devandersonchoi","email":"chltjdrhd777@gmail.com","actor":{"name":"devandersonchoi","email":"chltjdrhd777@gmail.com","type":"user"}},"directories":{},"maintainers":[{"name":"devandersonchoi","email":"chltjdrhd777@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gitip_1.8.6_1751588262462_0.6129878042511734"},"_hasShrinkwrap":false}},"maintainers":[{"name":"devandersonchoi","email":"chltjdrhd777@gmail.com"}],"description":"Automatically generate Git issues and pull requests for your workflow","homepage":"https://github.com/chltjdrhd777/gitip","keywords":["git","issue","pull request","automated git","github issues","github pull requests","workflow automation","git automation","issue generator","PR generator","github tools","collaboration","team collaboration","version control","git workflow","git convention","commit convention","coding convention"],"author":{"name":"devAnderson","email":"chltjdrhd777@gmail.com"},"bugs":{"email":"chltjdrhd7777777@gmail.com"},"license":"MIT","readme":"# 🌟 **gitip** 🌟\n\n

✨ A handy CLI tool to manage GitHub issues & pull requests with ease ✨

\n\n

\n \n

\n\n## πŸš€ **Getting Started**\n\n### Installation\n\n```sh\n# Install globally\nnpm install gitip -g\ngitip\n\n# Or run directly with npx\nnpx gitip\n```\n\n### Usage\n\n```sh\n1. Selection mode\ngitip\n\n2. Quick command mode\ngitip i # or gitip issue\ngitip p # or gitip pr\ngitip s # or gitip sync\ngitip c # or gitip clean\n```\n\n## πŸ“‹ **Environment Setup**\n\n### 1. Environment Configuration\n\nBy default, this tool operates in the **fork repo system** mode. ✨\n\nIf you prefer to use the **origin repo system** mode, simply include the `ORIGIN_REPO_OWNER` variable in your `.env` file. When `ORIGIN_REPO_OWNER` is detected, the tool will automatically switch to **origin repo system** mode, allowing you to interact directly with the original repository. πŸš€\n\n> - `fork repo system` = manage issues and pull requests in a **forked repository**\n> - `origin repo system` = manage issues and pull requests directly in the **original repository**\n\n---\n\n## πŸ”§ Example Configurations\n\n### πŸ”„ Environment Priority Loading\n\nThis tool determines which `.env` file to load based on the following priority order:\n\n1. `.env.local`\n2. `.env.test`\n3. `.env.development`\n4. `.env.production`\n5. Any other `.env.*` file (e.g., `.env.staging`, `.env.custom`)\n6. `.env`\n\nIf multiple `.env` files are present, the file with the highest priority will be loaded.\n\n> πŸ’‘ If you want to initialize the environment variables required, It is recommended to use the `init` command.
Please refer to the [**Commands**](#commands) section for more information.\n\n---\n\n### πŸ”„ Fork Repo System Configuration\n\nUse the following setup for working with a **forked repository**:\n\n```env\nGIT_ACCESS_TOKEN=your-github-access-token\nFORK_REPO_OWNER=fork-repo-owner-name\nUPSTREAM_REPO_OWNER=upstream-repo-owner-name\nREPO_NAME=repository-name\nDEFAULT_BRANCH_NAME=default-branch-name\nTEMPLATE_TITLE_PLACEHOLDER=(optional) issue template title placeholder\n```\n\n---\n\n### πŸ”— Origin Repo System Configuration\n\nUse the following setup for working directly with the **original repository**:\n\n```env\nGIT_ACCESS_TOKEN=your-github-access-token\nORIGIN_REPO_OWNER=origin-repo-owner-name\nREPO_NAME=repository-name\nDEFAULT_BRANCH_NAME=default-branch-name\nTEMPLATE_TITLE_PLACEHOLDER=(optional) issue template title placeholder\n```\n\n---\n\n## πŸ“ Notes\n\n- βœ… If the `ORIGIN_REPO_OWNER` variable is present in the `.env` file, **gitip automatically switches to origin repo system mode**.\n- 🚫 If `ORIGIN_REPO_OWNER` is missing, the tool defaults to **fork repo system mode**.\n- πŸ” The tool checks for `.env` files in the current directory and loads them based on the priority described above.\n- ⚠️ Ensure all required variables are included in the selected `.env` file to avoid runtime errors.\n\n### 3. Issue Templates\n\nThis tool uses GitHub issue templates. If a template isn't available, the default template will be used. To use a specific template, set the `TEMPLATE_TITLE_PLACEHOLDER` variable in your `.env` file.\n\n

\n \n

\n\n## ✨ **Features**\n\n### πŸ–ŠοΈ 1. Create an Issue\n\n- Easily create GitHub issues with just a few steps.\n\n

\n \n

\n\n

\n \n

\n\n### πŸ“‘ 2. Create a Pull Request\n\n[Prerequisite]\n\n1. Commit your changes.\n2. Select \"Create a pull request.\"\n\n- The pull request title is automatically suggested based on your latest commit message. However, only commits with conventional prefixes (like `feat:`, `test:`, `fix:`, etc.) will be extracted. For commits without these prefixes, you'll need to enter the title manually.\n- Related issues are automatically closed when the pull request is merged (if the base branch is the default branch).\n\n

\n \n

\n

\n \n

\n\n> [!NOTE]\n> To use the \"close\" keyword for related issues, the base branch must be the default branch.\n\n

\n \n

\n\n### πŸ”„ 3. Synchronize Fork with Origin\n\nKeep your fork updated with the origin branch effortlessly.\n\n**😭 Manual Method (Not Recommended)**:\n

\n\n

**☺️ Recommended Method (with gitip sync)**

\n\n### πŸ—‘οΈ 4. Clean Up Unused Issue Branches\n\nRemove unused branches locally and remotely with ease.\n\n#### 1. Local Debris:\n\n

\n \n

\n\n#### 2. Fork Debris:\n\n

\n \n

\n\n#### 3. Cleaned State:\n\n

\n \n

\n\n

\n \n

\n\n## πŸ“œ **CLI Commands**\n\n### General Options:\n\n- **`-o, --origin`**: Use origin repository (default is fork).\n- **`-v, --version`**: Display the current version.\n- **`-h, --help`**: Show help message.\n\n### Commands:\n\n#### **`init`**\n\n- Initialize default `.env` file with required environment variables.\n- This command will create or update the `env` file in your current directory.\n- **Usage**: `gitip init`\n\n#### **`issue` | `i`**\n\n- Manage GitHub issues: Create, update, or retrieve issues.\n- **Usage**: `gitip i`\n\n#### **`pr` | `p`**\n\n- Manage GitHub pull requests: Create, update, or list pull requests.\n- **Usage**: `gitip p`\n\n#### **`sync` | `s`**\n\n- Synchronize your fork with the origin repository.\n- **Usage**: `gitip s`\n\n#### **`clean` | `c`**\n\n- Remove unused branches locally or remotely.\n- **Usage**: `gitip c`\n\n## πŸ’‘ **Pro Tips**\n\n- Use the `TEMPLATE_TITLE_PLACEHOLDER` environment variable to customize your issue titles.\n- Keep your `.env` files updated for both fork and origin systems.\n\nEnjoy managing your GitHub repositories with **gitip**! 😊\n","readmeFilename":"README.md"}