Import structured issues from YAML/JSON files and remote repos into GitHub with full idempotency tracking, milestone mapping, labels, and assignees.
Designed from the ground up for developer efficiency and autonomous AI workflows.
Starts in under 3 milliseconds with zero runtime dependencies. Standalone static binaries compiled with full LTO optimization.
Tracks imported issues in import-log.json. Re-running imports skips already processed items without duplicating issues.
Resolves milestones by title or number, tags custom labels, and assigns teammates automatically during import.
Built-in agent-readme manual, structured JSON mode with --json, and machine-readable error envelopes on stderr.
Tokens never touch plaintext disk files. Integrates directly with macOS Keychain, Linux Secret Service, and Windows DPAPI.
Enforces explicit --account <name> targeting, preventing catastrophic accidents across personal, client, or enterprise organizations.
Straightforward commands for validating, previewing, and importing issues.
| Command | Description | Example |
|---|---|---|
import |
Import issues from YAML/JSON file or config into GitHub repo or inbox | gh-issue-import import issues.yaml --repo owner/repo -a work |
validate |
Validate file syntax, required fields, and milestone existence | gh-issue-import validate -f issues.yaml -r owner/repo -a work |
login |
Authenticate with GitHub PAT and save to native OS keystore | gh-issue-import login work --token ghp_... |
accounts list |
List configured accounts and verify token validity with GitHub | gh-issue-import accounts list --check |
accounts test |
Verify account connectivity and check for identity drift | gh-issue-import accounts test work |
accounts remove |
Remove account from config and clear token from OS keystore | gh-issue-import accounts remove work --yes |
agent-readme |
Print operating instructions and rules for AI agents | gh-issue-import agent-readme --json |