Skip to content

Architecture

GitHub Intel is a local-first command-line tool. The terminal interface is another view of the same cache.

Pieces

Piece Role
Configuration YAML files for defaults, profiles, and the repository list
Profiles Single-parent inheritance, then repository checks overrides
GitHub client One GET per call. Link headers are not followed
Synchroniser Bounded concurrency. One repository failure does not stop the run
Cache SQLite, under ~/.local/share/github-intel/cache.sqlite by default
Views The Status column and the detail table, built from the cache

Read and Write

sync is the writer. repo list, repo show, report, audit, and the terminal interface are readers. They do not call GitHub.

The client retries rate limits and 500, 502, 503, and 504. It does not store the token. Logs redact it.

Freshness

Each category has its own window. Metadata, releases, workflow definitions, issues, and standards can be fresh independently. The summary row that feeds the list columns uses the issues window. A change to stars or workflow state waits for that window or for --force.