ISEGORIA / SOFTWARE
WORLD MODEL MCP

Keep the finding.
Keep the evidence.
Keep room to revise.

Research memory for Codex and Claude that preserves what a source reports, what an assistant infers, and why you might change your mind.

Explore a synthetic example ↓Read the source ↗
● Local on your Mac · Human review · No hosted AI required
ONE RESEARCH CHECKPOINT◈
01 / SOURCEWhat was actually reported?Original material + a precise locator
↓
02 / CLAIMA finding, with its conditions.Scope · assessment · uncertainty
↓
03 / INFERENCEA conclusion you can inspect.Premises + explicit assumptions
✓ Human review↺ Revision history
THE IMPORTANT DISTINCTION

“Accepted” means reviewed for inclusion.
It does not mean proven true.

An accepted hypothesis remains a hypothesis. Similarity and repeated citations do not turn it into a fact.

INTERACTIVE EXAMPLE

Watch a finding become revisable knowledge.

Follow one checkpoint across recording, human review, a fresh assistant session, and conflicting evidence.

FICTIONAL DEMONSTRATIONIn-memory browser example. No connection to a real knowledge store. Nothing is saved or uploaded.
SYNTHETIC / GENERALNot recorded

HISTORY

    The actual application uses a persistent SQLite store, independent MCP processes, and an authenticated local inspector. This example illustrates that workflow with deliberately fictional findings.

    THE LOCAL PRODUCT

    A durable research record,
    with a useful interface.

    Browse evidence and assumptions, compare proposal changes, explore a bounded graph, and recover earlier accepted revisions.

    Read the verification report ↗
    01

    Evidence stays attached

    Source passages, locators, applicable conditions, and provenance travel with a claim.

    02

    Review comes first

    Assistants preserve pending proposals. A person reviews them before acceptance.

    03

    Disagreement stays visible

    Challenges do not silently rewrite accepted knowledge. Revision history remains inspectable.

    04

    Retrieval stays local

    English/Japanese keyword and graph search work offline. A verified multilingual model is optional.

    FROM THE RUNNING APPLICATION

    The evidence inspector.

    Captured from the local browser workflow using labeled synthetic data.

    World Model local inspector showing a synthetic sleep finding, its population and conditions, and linked evidence.
    RUN IT ON YOUR MAC

    One local store.
    More than one assistant.

    Apple Silicon macOS. The setup script installs an isolated Node.js 24 runtime and the locked dependencies. Connect Codex or Claude using generated absolute-path MCP configuration.

    Installation guide ↗Client setup ↗API and schemas ↗
    LOCAL INSTALLATION
    git clone https://github.com/theisegoria/world-model-mcp.git
cd world-model-mcp
./scripts/setup.sh
./bin/world-model-mcp open

    Optional model downloads require an explicit install action. Personal research is not imported automatically.

    What this does—and what it cannot promise.

    It supplies durable, inspectable, revisable knowledge to connected assistants. It does not change model weights, guarantee truth, or guarantee that an assistant follows research instructions. Human review is a workflow safeguard, not a security boundary against unrestricted programs running under the same OS account.

    Build, protocol, browser, semantic, benchmark, and real-client evidence are reported separately in the repository. Any unverified client integration is identified there.