Github Current Intelligence CLI

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