How niethesan96/gitops-human works
GitOps for Humans turns categorized Git commit messages into productivity records and spreadsheet updates, with brainstorm commits also producing a roadmap. The documented workflow runs from a Git push through GitHub and an ngrok tunnel to the Flask webhook, which parses messages with Gemini and dispatches them to PostgreSQL and Google Sheets. README describes a PostgreSQL trigger, but its implementation is not present in the supplied source; the graph shows it only as a documented capability. Runtime behavior is concentrated in app.py.
Main entry points: app.py Type dispatcher · ngrok.exe ngrok tunnel
Components 18
Commit Ingress
- Git push
- GitHub webhook
- ngrok tunnel
ngrok.exe - Webhook handler
app.py
AI Processing
- Commit parser
app.py - Type dispatcher
app.py - Roadmap generator
app.py
Record Routing
- Commit records
- Commit trigger
- DB connection
app.py - Tasks and bugs
app.py - Meetings
app.py - Expenses
app.py - Ideas and brainstorms
app.py - Sheets tab writer
app.py
External Services
- Google Gemini
- Google Sheets
Other components
- Developer
Connections 19
- Developer → Git push: pushes commits
- Git push → GitHub webhook: sends push
- GitHub webhook → ngrok tunnel: posts webhook
- ngrok tunnel → Webhook handler: forwards payload
- Webhook handler → DB connection: opens connection
- Webhook handler → Commit records: inserts raw commits
- Commit records → Commit trigger: fires trigger
- Webhook handler → Commit parser: parses message
- Commit parser → Google Gemini: requests JSON parse
- Webhook handler → Type dispatcher: routes parsed commit
- Type dispatcher → Roadmap generator: generates brainstorm roadmap
- Roadmap generator → Google Gemini: requests roadmap JSON
- Type dispatcher → Tasks and bugs: writes task or bug
- Type dispatcher → Meetings: writes meeting
- Type dispatcher → Expenses: writes expense
- Type dispatcher → Ideas and brainstorms: writes idea or topic
- Type dispatcher → Sheets tab writer: appends categorized row
- Sheets tab writer → Google Sheets: creates tabs and appends rows
- Webhook handler → Commit records: marks processed