__ __ _ _ _____ _ _ | \/ (_)_ __ __| || ___(_)___| |__ | |\/| | | '_ \ / _` || |_ | / __| '_ \ | | | | | | | | (_| || _| | \__ \ | | | |_| |_|_|_| |_|\__,_||_| |_|___/_| |_| fish the mind.
cat README.md
what is mindfish
MindFish is a Cognitive API for AI agents.
It models how a human thinks — not what they said.
Your agent calls it as a tool. The user does nothing.
Conversations go in. Structured cognition comes out.
mindfish describe --short
what it does for your agent
→ Extracts beliefs, values, and reasoning patterns from conversations
→ Predicts what a specific user would choose — with calibrated confidence
→ Resolves value conflicts: knows which value wins, under what conditions
→ Models hard boundaries — things a user will never do, regardless of context
→ Self-corrects: every hypothesis verified against real behavior
mindfish diff --vs memory-apis
why this isn't another memory layer
Memory APIs store what users said.
MindFish models why they said it.
Memory APIs retrieve facts.
MindFish resolves contradictions.
Memory APIs wait for data.
MindFish actively probes for what's missing.
mindfish status
version: v0-preview
status: private beta
since: 2026-02-13
users: 10+ active (closed beta)
api docs: coming soon