Quick Start

Get up and running with Ghit in under 5 minutes.

Install

pnpm

pnpm add -g ghit

npm

npm install -g ghit

yarn

yarn global add ghit

Authenticate

ghit login

Follow the browser OAuth flow to grant access.

Set Default Repository

ghit set-repo owner/repo

Common Workflows

Browse Issues Interactively

ghit issues

Navigate through issues, view details, close/reopen, edit, or delete.

Create a Single Issue

ghit issues:create --title "Bug found" --body "Description"

Seed Multiple Issues

Create a directory with markdown files (one per issue):

issues/
├── 001-setup-ci.md
├── 002-add-tests.md
└── 003-update-docs.md

Each file:

---
type: Issue Type (Feature, Task, Bug)
title: Setup CI Pipeline
labels: ['enhancement', 'ci']
assignees: ['username']
---

Add GitHub Actions workflow for automated testing.

Then seed:

ghit issues:seed ./issues

Update Issues in Bulk

Modify your markdown files, then:

ghit issues:update ./issues

Ghit uses smart diffing to update only changed content.

Delete Issues

Interactively multiselcet and delte issues

ghit issues:delete

Generated Commands

Generate CLI commands from GitHub's OpenAPI spec:

ghit generate:apis

Now use any GitHub REST endpoint:

# List repos for authenticated user
ghit repos:list-for-authenticated-user --per_page 100

# Create a gist
ghit gists:create --description "My snippet" --public true

# Get user info
ghit users:get-authenticated

Command Discovery

Run ghit --help to see all available commands, including generated ones and their expected options and arguments.

Configuration Tips

Check Current Config

ghit info

Enable Debug Mode

ghit config --debug true

Switch Repositories Quickly

ghit set-repo different-owner/different-repo

Next Steps

• Getting Started Guide for detailed setup
• Commands Reference for all command options