indigokarasu/finch has 31 GitHub stars and 2 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-17 14:18 UTC. Last push 2026-11-15.
Measured star growth
- in 24h
- 0
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Finch: self-improvement orchestrator — mines session history to detect corrections, breakthroughs, and behavioral patterns.
AIREADME.md
OriginalFinch
Mines session history for learning signals, keeps MEMORY.md within its cap, and records what is in flight. It observes and records; it does not act.
Why Finch?
Skills drift. Finch catches the drift: it scans session transcripts for corrections, directives, breakthroughs and methodologies, then routes each one to where it belongs, so the system improves without manual bookkeeping.
Quick start
hermes skills install ocas-finch
What it does
- Mines sessions for corrections, Always/Never directives, breakthroughs and methodologies.
- Routes findings: directives go to MEMORY.md through
memory_guard.py; skill patches are staged forocas-fellowreview; user-scoped signals go to Chronicle. - Compacts MEMORY.md to stay within its character cap without losing directives.
- Tracks work in flight (
finch:track): projects, in-flight tasks and todos from sessions, journals and logs, written totracker.jsonandtracker.md. - Scans system health (
finch:scan): sessions, cron health, kanban and system signals, with a ledger entry per scan.
Since 3.3.0 Finch does not read email, calendar or Drive, and it does not execute tasks. Mentor routes tasks to the owning skill.
Jobs and commands
| Name | What it does |
|---|---|
finch:scan |
Scheduled signal scan (every 2h) |
finch:track |
Records projects, in-flight tasks and todos |
finch:daily / finch:weekly |
Daily mining and compaction; weekly review |
finch.mine |
Mine sessions for signals only |
finch.compact |
Compact MEMORY.md only |
finch.dry-run |
Full pipeline without writing anything |
Development
python -m unittest discover -s tests -v # includes every scripts/test_*.py suite
python scripts/check_no_pii.py # must pass before any push
This repo is public. Publish through a PR that CI checks, never a blind git add -A to main: see references/reference-file-workflow.md § Publishing. Reference docs are indexed in references/README.md.
Dependencies
Hermes Agent runtime. Reads session transcripts, journals, logs and MEMORY.md from the active profile.
Part of the OCAS Agent Suite.