instruction-hub

A CLI tool to manage GitHub Copilot instructions from multiple repositories, including GitHub Enterprise.

Tired of manually copying and pasting instructions from various GitHub repositories?

instruction-hub simplifies the process by allowing you to pull copilot instructions from any repo.

Features

• 🏢 GitHub Enterprise Support: Works with private GitHub Enterprise repos as well as public GitHub (detects gh cli auth token)
• 🔐 Automatic Authentication: Uses GitHub CLI authentication when available
• 📦 Interactive Installation: Browse and install instructions with an interactive CLI interface
• 🚀 Direct URL Installation: Install instructions directly from a GitHub file URL with a single command
• 🗑️ Easy Uninstallation: Remove managed instructions with interactive selection
• 📋 Updates: Pull the latest versions of installed instructions from their source repositories

Usage:

# Quick start: Install directly from a GitHub file URL
npx instruction-hub add https://github.com/owner/repo/blob/main/instructions/my-instruction.md
# This automatically adds the repo to config and installs the instruction!

# Or add repositories first, then install interactively
npx instruction-hub config add https://github.com/owner/my-copilot-instructions
npx instruction-hub config add owner/repo
npx instruction-hub config add https://ghe.company.com/company-org/company-copilot-instructions

# Install instructions interactively
npx instruction-hub install
# (or add, or just i)

# List managed instructions
npx instruction-hub list

# Update managed instructions
npx instruction-hub update

# Uninstall instructions
npx instruction-hub uninstall
# (or remove, or rm)

Shorthand Command

For convenience, ih is available as a shorthand alias for instruction-hub:

If installed globally (npm i -g instruction-hub), you can use it directly:

# Direct install from URL
ih add https://github.com/owner/repo/blob/main/file.md

# Or use the traditional way
ih config add owner/repo
ih i
ih rm

Authentication

GitHub Enterprise & Private Repositories

For private repositories or GitHub Enterprise instances, you'll need to authenticate using the GitHub CLI:

# Install GitHub CLI (if not already installed)
brew install gh

# Authenticate with public GitHub
gh auth login

# Authenticate with GitHub Enterprise
gh auth login --hostname ghe.company.com

# Verify authentication
gh auth status

The tool automatically detects your authentication and uses the appropriate tokens for API requests.

Supported Authentication Methods

• GitHub CLI: Automatically uses tokens from gh auth (recommended)
• Public repositories: No authentication required
• Multiple instances: Supports both public GitHub and enterprise instances simultaneously

Configuration

Configuration is stored globally in ~/.instruction-hub/config.json and includes:

• List of configured repositories

License

MIT

Contributing

Issues and pull requests are welcome!