Public GitHub repository, release, search, and security advisory signals for agent research.
Created by @hnshah (Hiten Shah).
Quick Start
1. Install
See Install above.
2. Verify Setup
github-intel-pp-cli doctor
This checks your configuration.
3. Try Your First Command
github-intel-pp-cli advisories
Usage
Run github-intel-pp-cli --help for the full command reference and flag list.
Commands
advisories
Manage advisories
github-intel-pp-cli advisories - List global security advisories
github-current-intelligence-search
Manage github current intelligence search
github-intel-pp-cli github-current-intelligence-search - Search repositories
repos
Manage repos
github-intel-pp-cli repos <owner> <repo> - Get repository metadata
Output Formats
# Human-readable table (default in terminal, JSON when piped)
github-intel-pp-cli advisories
# JSON for scripting and agents
github-intel-pp-cli advisories --json
# Filter to specific fields
github-intel-pp-cli advisories --json --select id,name,status
# Dry run — show the request without sending
github-intel-pp-cli advisories --dry-run
# Agent mode — JSON + compact + no prompts in one flag
github-intel-pp-cli advisories --agent
Agent Usage
This CLI is designed for AI agent consumption:
- Non-interactive - never prompts, every input is a flag
- Pipeable -
--json output to stdout, errors to stderr
- Filterable -
--select id,name returns only fields you need
- Previewable -
--dry-run shows the request without sending
- Read-only by default - this CLI does not create, update, delete, publish, send, or mutate remote resources
- Offline-friendly - sync/search commands can use the local SQLite store when available
- Agent-safe by default - no colors or formatting unless
--human-friendly is set
Exit codes: 0 success, 2 usage error, 3 not found, 5 API error, 7 rate limited, 10 config error.
Health Check
github-intel-pp-cli doctor
Verifies configuration and connectivity to the API.
Configuration
Config file: ~/.config/github-current-intelligence-pp-cli/config.toml
Static request headers can be configured under headers; per-command header overrides take precedence.
Troubleshooting
Not found errors (exit code 3)
- Check the resource ID is correct
- Run the
list command to see available items
Generated by CLI Printing Press