GROW = Governed Reproducible Operational Workflow — de wet waar elke stap onder draait.
Het zaadje dat jij controleert — niet de agent. Een zero-trust AI-werkbank waarin elke stap machine-bewezen is, de mens het laatste woord heeft, en niets verdwijnt.
Grow Kit is een AI-werkbank met een harnas. Je geeft een idee, een agent voert het uit, en de machine bewijst bij elke stap dat het klopt. Jij keurt goed of af. De agent mag nooit zeggen "klaar" — hij moet het bewijzen.
- Niets draait zonder bevestigde scope. Wat de poort niet vrijgeeft, kan de agent niet uitvoeren.
- Succes is bewijs, nooit een praatje. Vijf gecodeerde controles (
shell_check,file_exists,json_valid,file_equals,http_check) worden door de motor zelf uitgevoerd. - De geschiedenis is append-only. Nooit overschrijven, nooit teruggedraaien. Het verleden blijft intact.
Volledige uitleg: docs/HOE-HET-WERKT.md.
Grow Kit is MIT-opensource. De motor en de vijf bewijscontroles blijven altijd gratis. Wil je de groei steunen? Bekijk de sponsor-tiers — van 🌱 Zaadje (€5/mnd) tot 🏛️ Boomgaard (€500/mnd).
Native macOS-app (SwiftUI) in editorial-monochrome stijl. De zijbalk begint met de drie hoofdingangen — 00 Vandaag, 01 Opdrachten, 02 Bibliotheek — en al het gereedschap daaronder zit onder één uitklapper Gereedschappen.
| Nr. | Scherm | Wat het doet |
|---|---|---|
| 00 | Vandaag | Begroeting, de vier cijfers (familie, saldo, wacht op jou, geschiedenis) en de knowledge graph |
| 01 | Opdrachten | Eén dossier per opdracht: plan, grenzen, uitvoering, bewijs, jouw oordeel — met drie lokale voorbeelden |
| 02 | Bibliotheek | Gecureerde audit-prompts, letterlijk en alleen-lezen |
| Gereedschappen | ||
| 03 | Agent Chat | Praat met de familie; Thought-blok per antwoord, gesprek wissen (→archief), geschiedenis |
| 04 | Status | Identiteit, register, tellers, logboek |
| 05 | Planten | Kiemkeuze → concept → motor met bewijs |
| 06 | Goedkeuringen | Ratificatie: mens keurt goed of af |
| 07 | Dialoog | Scope-poort, prompt-slijper, ronde tafel |
| 08 | Agenten | Gouverneur: familie, observaties, taak-contracten |
| 09 | Automatiek | Eén zin in, automation-plan uit — KairOS stelt voor, jij keurt |
| 10 | Knowledge Graph | Brein-verbanden; klik op een sectie om in te zoeken |
| 11 | Vangnet | Opgevangen review-aanroepen en uitkomsten |
| 12 | Audit | Volledig, append-only logboek |
| 13 | Agenda | Cron, wachtende goedkeuringen en taken |
| 14 | Secure Vault | Echte kluizen via macOS hdiutil (AES-256/APFS) |
| 15 | Amnesia Protocol | Gevoelige tekst anonimiseren en herstellen |
| 16 | Digitale Kloon | Persoonlijke kluis: 6 categorieën, AES-256-GCM, PIN + Touch ID |
| 17 | Hervatten | Crash-herstel uit het logboek |
| 18 | Taak | Boom-pad + governor → takenlijst met bewijs |
| 19 | Telegram Connect | De familie koppelen aan jouw eigen Telegram, stap voor stap |
| 20 | CyberSeed | Zes niveaus (Sprout → Amazone), lokaal (Ollama) of frontier-cloud (OpenRouter), eigen SOUL |
| 21 | Skills | Welke skills draaien er op jouw GrowKit? |
| 25 | Rondleiding | Het ontwerp in vijf schermen |
| 26 | Uitleg | De motor uitgelegd |
| 27 | Best Practices | Kerninzichten uit eigen onderzoek, met zoeken |
Instellingen staat permanent onderaan de zijbalk. De nummers 22–24 zijn voorbereide schermen (browser, IDE, connectors) die nog niet in het menu staan.
Zeven agents, elk met een eigen rol en stem. Ze sturen in plaats van mee-praten: behulpzaam altijd, meegaand nooit.
| Agent | Rol | Stem |
|---|---|---|
| KairOS | Bouwer & coördinator — de eerste agent, naamdrager van het toekomstige KairOS-OS | Kalm, degelijk; praat als een ervaren voorman |
| Riri | Research — onderzoek, ontwerp, externe review | Warm en scherp; noemt altijd haar bron |
| Vigil | Bewaking — infrastructuur, security, signalen | Alert en zakelijk; korte feitelijke meldingen |
| Libra | Kosten — budget, pricing, verbruik | Bedachtzaam en cijfergericht; noemt de euro's |
| Memoria | Geheugen — herinneringen, logboeken, overzicht | Vertellend; vindt data en dataprecies terug |
| Codex | Archief — brein-boekingen, documenten, orde | Ordelijk; genummerde samenvattingen |
| Genius | Observer — kijkt mee, levert aan, groeit in fasen | Stil observerend; zegt weinig, raakt wel |
De agents kennen de gebruiker bij naam (het van-veld in elk chatbericht) en spreken hem aan met zijn naam of "de Baas" — nooit anders. Hun gedrag staat in SOUL-bestanden op de eigen server: focus-manifest, antwoord-verdeling, titulatuur en per-agent stem.
Voor wie verder wil kijken:
- Python-kern (
kern/, 54 modules): scope-poort, stappen-motor met faalcontract, vijf machine-controles, review-laag, ratificatie, leesroute, crash-herstel, boom-register, vangnet (SQLite), agent-familie, Knowledge Graph, prompt-bibliotheek, Secure Vault (hdiutil), Amnesia (anonimiseren), Digitale Kloon (AES-256-GCM viacryptographyin een repo-eigen.venv— bewuste uitzondering op stdlib-only), Best Practices. - Adapter (
adapter.py): JSON-CLI met 74 commando's over de kern — de enige poort tussen app en motor. - Opdrachtdossier (
kern/growkit_opdrachten.py): één blijvend dossier per opdracht — bevestigd plan metplan_hash, uitvoerslot tegen dubbel draaien, wachtende mens-stappen, oordeel en PANIC-herstel. Transactionele opslag (kern/growkit_opslag.py: flock + atomair schrijven). - Pauze is geen fout (
kern/growkit_motor.py):uitkomst()benoemt wat een run deed (geslaagd · wacht_op_mens · gepauzeerd · gefaald) enmachine_deel_voltooid()zegt of alleen nog jouw besluit openstaat. Een mens-moment levert exit 0 met statuswacht_op_mens; een echt falen houdt exit 2. - Gegevensroute (
kern/growkit_route.py): leidt per plan af of er iets de machine verlaat (lokaal · eigen VPS · cloud). Een profiel mag het zelf verklaren; verklaart het minder dan zijn commando's doen, dan wint het zwaarste en verschijnt er een waarschuwing. Cloud vraagt om expliciete toestemming — zonder die toestemming start de opdracht niet. - Voorbeelden (
kern/growkit_voorbeelden.py+profielen/): drie lokale voorbeeldopdrachten (projectcontrole, documentenoverzicht, terugkerend rapport), elk met een eigen plan, sjablonen en een mens-stap. Eén bron: het profiel draagt zijn eigen voorbeeld-blok. - CyberSeed (
kern/growkit_cyberseed.py+kern/growkit_ram.py): zes modelniveaus — Sprout v0.5, Root v1.0, Leaf v1.5, Tree v2.0, Jungle v2.5, Amazone v3.0 — elk met een eigen systeemprompt op autonomie-schaal (governance in alle tiers). Per niveau kies je lokaal (Ollama, RAM-klasse bepaalt het model; te zware namen zijn vergrendeld met min-RAM-uitleg) of cloud (OpenRouter, frontier-opties per naam). Zelfbijgewerkte SOUL-snapshot uit GrowKit-data; routinglog per aanroep; chatlog append-only; wissen alleen metbevestig=true. Eigen OpenRouter-model per naam mogelijk mét tier-validatie (±1 niveau,force=truevoor bewuste keuze). Lokaal is de eindbestemming — cloud is de brug. Niets verlaat de Mac bij lokaal.
| Niveau | Naam | Lokaal (24 GB Mac) | Cloud-opties (OpenRouter) |
|---|---|---|---|
| 1 | Sprout v0.5 — instap, kort | qwen3:4b | gemini-3.5-flash · gpt-5.6-luna · glm-5.3-flash |
| 2 | Root v1.0 — SOUL-bewust, suggereert | qwen3:8b | deepseek-v4-pro · gpt-5.6-terra |
| 3 | Leaf v1.5 — taakspecifiek (Vangnet) | qwen3:14b | qwen3.8-max · kimi-k2.6 |
| 4 | Tree v2.0 — coördinator/orkestratie | gpt-oss:20b | claude-sonnet-5 · glm-5.2 |
| 5 | Jungle v2.5 — patronen, zwaar | qwen3.6:27b | grok-4.6 · kimi-k3 · gpt-5.6-sol |
| 6 | Amazone v3.0 — frontier | qwen3:32b | claude-opus-5 · claude-fable-5.1 · gpt-6-astra |
- Lokaal: RAM-klasse bepaalt het model per niveau (8–15 / 16–23 / 24–36 / 48–64 / 96+ GB); op een 24 GB Mac zijn alle zes beschikbaar. Volledige mapping:
kern/data/cyberseed_models.json. - Cloud: eerste optie is de standaard; eigen model-id per niveau kan via scherm 19 (met tier-validatie).
- De systeemprompt hoort bij de naam, niet bij het model — Sprout gedraagt zich als Sprout, welk model er ook onder hangt.
- Automatiek (
kern/growkit_automatiek.py): het zes-blokken-model (doel & trigger, bronnen, stappen, kwaliteit, uitvoering, randvoorwaarden) uit de Automatiek-planner; secrets-scanner weigert plannen met keys;automatiekvoorstelstuurt je wens naar KairOS, zijn JSON-antwoord wordt een plan. - Agent Chat-pijplijn: bericht →
~/.../agenttaken/<agent>/wachtrij/*.jsonop de VPS → poller (cron, 1 min) →hermes chat -q --profile <agent>met[van: NAAM]-prefix → antwoord gepuurd van CLI-meuk (zuiver_antwoord) + redenatie apart bewaard → antwoorden/.json. - Chat-geschiedenis: wissen = verplaatsen naar
<agent>/geschiedenis/(antwoorden alsantwoord-*.json); definitief wissen vereistbevestig=true. Elk antwoord kan eenredenatie-veld meedragen (het denkproces, per bericht in- en uitklapbaar). - SSH: de app praat met de VPS via
GROWKIT_HOST(omgeving of.envin de repo-root; in.gitignore). - SOUL-bestanden: gedrag, rol en stem van elke agent op de VPS (
/root/.hermes/SOUL.md+ profiel-SOUL's): focus-manifest, titulatuur ("Tiëndo" of "de Baas", nooit "papa"/"oom"), antwoord-verdeelregel, per-agent STEM.
git clone git@github.com:parvenuprompting/Grow-Kit.git
cd Grow-Kit
python3 -m venv .venv && .venv/bin/pip install cryptography
.venv/bin/python -m unittest discover tests # 802 tests
python3 seed.py # geleende-agent-modus: kiemkeuze + planten
python3 loop.py # het harnas: planten / hervatten / taak / ratificatie / status
# de macOS-app bouwen (XcodeGen + xcodebuild):
(cd app && bash build.sh)- Review-rollen: kopieer
reviewconfig.voorbeeld.json→reviewconfig.json(in.gitignore, nooit in de repo). - VPS-verbinding:
export GROWKIT_HOST=gebruiker@jouw-vpsof zet het in.env. - Verdere uitleg:
SEED.md→profielen/INDEX.md→docs/HOE-HET-WERKT.md.
- Open de app → 00 Vandaag.
- Kies links onder VOORBEELDEN één van de drie: Projectcontrole, Documentenoverzicht of Terugkerend rapport.
- Je ziet het plan, de afgesproken grenzen en de gegevensroute — er draait nog niets.
- Bevestig: de machine doet de stappen en legt per stap bewijs vast.
- De opdracht pauzeert bij het mens-moment. Lees het resultaat, geef je reden en keur goed of wijs af.
De drie voorbeelden werken zonder VPS, zonder sleutel en zonder internet: ze tellen en controleren alleen bestanden op jouw machine.
Grow-Kit/
├── SEED.md ← geboortebrief
├── seed.py ← plant-mechanisme
├── loop.py ← het harnas: orchestratie zonder agent
├── adapter.py ← JSON-CLI brug (74 commando's)
├── kern/ ← 54 modules
├── profielen/ ← bomen: JSON-stappenplannen met gecodeerd bewijs
├── groei/ ← groeilaag-instructie
├── tests/ ← 802 tests + 13 E2E-scripts
├── app/ ← macOS SwiftUI-app
│ ├── Sources/ ← views + Thema/Bouwstenen
│ ├── Fonts/ ← Fraunces + Inter (SIL OFL)
│ └── build.sh ← XcodeGen + xcodebuild
├── docs/
│ ├── HOE-HET-WERKT.md ← de complete uitleg
│ ├── plannen/ ← bouwplannen (o.a. Automatiek-inbouw)
│ └── mockups/ ← UI-mockups
└── README.md
Elke push en PR draait automatisch CI (GitHub Actions):
- Tests — de volledige unittest-suite; rood = merge geblokkeerd
- Secrets-scan — dezelfde key-patronen als het taak-contract, over elke diff; een echte key blokkeert de push
- macOS-build — GrowKit.app moet compileren met fonts ingebed (op main)
- 799 in CI (Linux); 818 op macOS — 19 Digitale-Kloon-tests vereisen de macOS Keychain. (unittest; de enige externe dependency is
cryptographyvoor de Digitale Kloon, in een repo-eigen.venv— bewuste, gedocumenteerde keuze) - 13 end-to-end-scripts: fase-testen + slice-E2E
- Test 4 bewijst agent-onafhankelijkheid: harnas plant, crasht (
kill -9), hervat en ratificeert — met alleen python3 - Elke nieuwe slice TDD: eerst rood, dan groen, dan end-to-end
Grow Kit is lokaal-eerst, en dat is een belofte die je per opdracht kunt controleren in plaats van op een badge te vertrouwen. Elke opdracht toont vóór het draaien zijn gegevensroute:
| Route | Wat het betekent |
|---|---|
| Lokaal | Alles gebeurt op jouw machine. Geen sleutel, geen verbinding nodig. |
| Eigen VPS | Er gaat iets naar je eigen server (GROWKIT_HOST) — niets daarbuiten. |
| Cloud | Er gaat inhoud naar een clouddienst buiten je eigen systemen. |
De route wordt afgeleid uit de commando's van het plan (ssh/scp → eigen VPS,
curl/wget/http(s) → cloud). Verklaart een profiel mínder dan zijn commando's
doen, dan wint het zwaarste en verschijnt er een waarschuwing — geen stille keuze.
Cloud start nooit vanzelf. Is de route cloud, dan blijft de uitvoerknop dicht tot je met een reden toestemming geeft. Dat besluit landt in de geschiedenis en is net zo zichtbaar in te trekken. De motor weigert de uitvoering ook als een script het zonder toestemming probeert.
Eerlijk over de rest van het huis: Agent Chat loopt via je eigen VPS, CyberSeed kiest per niveau lokaal (Ollama) of cloud (OpenRouter) — die keuze maak jij, en op een 24 GB Mac zijn alle zes niveaus lokaal beschikbaar. De drie voorbeeldopdrachten, de motor, de vijf bewijscontroles en de opslag zijn volledig lokaal, kosten € 0 en hebben geen sleutel nodig.
Grow Kit gaat ervan uit dat de AI fouten maakt — zero-trust. De interpretatie van "is het gelukt?" ligt nooit bij het model, maar bij een deterministische controlelaag.
Geïnspireerd door het "Zen of Reticulum"-principe: een tool is nooit neutraal. Een tool is intentie, gekristalliseerd. Grow Kit is gebouwd met de bedoeling dat de mens bepaalt — niet de agent, niet de provider, niet de infrastructuur.
Ik ben Tiëndo, vrachtwagenchauffeur. Ik bouw dit project in mijn eentje, in de avonden naast fulltime werk. Dit is een build-in-public project: je ziet het groeien, inclusief de missers. Volg de voortgang op X (@GrowKitHarnas). Vragen? Open een issue.
MIT — zie LICENSE.
Buiten bereik getest: de software is ontworpen voor autonoom gebruik. De gebruiker blijft eindverantwoordelijk voor wat de agent uitvoert.
Pull requests zijn welkom. Elke bijdrage moet vergezeld zijn van de bijbehorende tests — eerst rood, dan groen. Bewijs telt.
- PANIC-knop (
kern/growkit_panic.py): één commando pauzeert alles — motor stopt, geen merges, geen pushes. Reden verplicht. Elke panic/herstel is een nieuwe append-only logboek-entry. Herstel nooit automatisch; de Baas beslist. Adapter-commando's:panic,panicherstel,panicstatus.