How sarverott/gitrecon works
gitrecon collects GitHub and related public-source activity, buffers it for repeatable analysis, and helps users map relationships and detect activity patterns. Its broader capabilities include cloned-repository analysis, history visualizations, content generation, atlas dataset maintenance, and offline text translation. Edges follow documented command workflows and explicit source references; several subsystem internals were not sampled, so uncertain implementation links are omitted.
Main entry points: collect.py Collection commands · github_api.py GitHub API client · __init__.py CLI commands · app.py Interactive menu
Components 27
User interfaces
- CLI commands
src/gitrecon/cli/__init__.py - Interactive menu
src/gitrecon/tui/app.py - Runtime config
src/gitrecon/config.py
Collection and storage
- Collection commands
src/gitrecon/cli/collect.py - GitHub API client
src/gitrecon/sources/github_api.py - Activity sources
src/gitrecon/sources - Link catalog
src/gitrecon/sources/links.py - Raw activity buffer
src/gitrecon/storage/rawbuffer.py
Analysis and mapping
- GitHub entity models
src/gitrecon/models/base.py - Activity labels
src/gitrecon/analysis/rules.py - Activity timeline
src/gitrecon/analysis/timeline.py - Activity graph
src/gitrecon/mapping/graph.py - Repository analysis
src/gitrecon/code/analyze.py - Repository relations
src/gitrecon/code/relations.py - History visualizations
src/gitrecon/mapping/gitgraph.py - Contributor mapping
src/gitrecon/mapping/contributors.py
Content and text
- Digest summaries
src/gitrecon/digest/summarize.py - Draft posts
src/gitrecon/digest/posts.py - Text utilities
src/gitrecon/text/tokenizer.py - Offline translation
src/gitrecon/translate/argos.py
Atlas and integrations
- Atlas updates
src/gitrecon/atlas/update.py - Atlas namespaces
src/gitrecon/atlas/namespace.py - Dataset sync
src/gitrecon/hub/huggingface.py
Other components
- User
- Ollama
- xAI
- Hugging Face Hub
Connections 27
- User → CLI commands: runs commands
- User → Interactive menu: opens menu
- Interactive menu → CLI commands: launches commands
- CLI commands → Collection commands: dispatches collection
- Collection commands → GitHub API client: requests GitHub data
src/gitrecon/cli/collect.py - GitHub API client → Runtime config: uses API settings
src/gitrecon/sources/github_api.py - GitHub API client → User: calls GitHub API
- Collection commands → Activity sources: collects source data
src/gitrecon/cli/collect.py - Collection commands → Raw activity buffer: stores activity
- Collection commands → Link catalog: harvests links
src/gitrecon/cli/collect.py - User → Activity graph: inspects activity map
- User → Activity labels: requests labels
- Activity labels → Activity timeline: uses activity windows
src/gitrecon/analysis/rules.py - User → Repository analysis: analyzes clones
- User → Repository relations: finds repository ties
- User → History visualizations: renders Git history
- User → Contributor mapping: maps contributors
- User → Digest summaries: requests summary
- Digest summaries → Ollama: summarizes locally
- User → Draft posts: requests drafts
- Draft posts → xAI: generates content
- User → Text utilities: runs text tools
- User → Offline translation: translates text
- User → Atlas updates: updates atlas
- Atlas updates → Atlas namespaces: updates namespaces
- User → Dataset sync: syncs dataset
- Dataset sync → Hugging Face Hub: pulls and pushes
src/gitrecon/hub/huggingface.py