Cruxible Core

by cruxible-ai

7 stars
193 downloads
Not rated
GitHub

About

Cruxible Core is a deterministic, typed state layer for AI agents and human teams to operate on verifiable, governed domain state. It models entity and relationship types, write rules, and recurring workflows in a Terraform-like config, and the runtime enforces them. The core…

Details

Author
cruxible-ai
GitHub stars
7
Downloads
193
Categories
Other

- Deterministic ingest: state enters row by row from pinned artifacts.
- Governed writes: proposal flow with declared evidence and human review.
- Executable model: declared workflows are previewable, replayable, and versioned.
- Reproducible reads: same query, same state, same result with a receipt.
- No LLM inside: core is a pure deterministic layer, works with any agent.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Cruxible Core
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install with pip install cruxible, then start a local daemon with CRUXIBLE_SERVER_STATE_DIR="$HOME/.cruxible/sandbox" cruxible server start. Initialize a domain with cruxible init --kit <name>, connect an agent session with cruxible context connect, run deterministic workflows with cruxible run and cruxible apply, propose governed claims with cruxible propose, and resolve them with cruxible group resolve. Queries return receipted results via cruxible query run.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "cruxible core": {
            "cruxible": {
                "command": "cruxible-mcp",
                "env": {
                    "CRUXIBLE_MODE": "admin"
                }
            }
        }
    }
}

McpServers

{
    "cruxible": {
        "command": "cruxible-mcp",
        "env": {
            "CRUXIBLE_MODE": "admin"
        }
    }
}

Cruxible

PyPI version
Python 3.11+
License: Apache 2.0

Cruxible is hard state for AI agents — a typed, verifiable state layer
that teams of agents and humans operate together. Work compounds into a
record of what you've determined to be true: every claim reviewed and linked
to its evidence. When the expensive question arrives (which assets are
exposed? what breaks downstream? is this authority still good law?), the
answer is computed over established truth, not guessed from a pile of
context.

You model your domain in a Terraform-like config: entity and relationship
types, deterministic workflows, write rules. The runtime enforces it.

<p align="center">
Cruxible architecture: source systems are pinned as artifacts, workflows propose row-matched claims into domain state, the agent operation layer reviews and mints them, and reads come back as deterministic queries with receipts
</p>

- State enters deterministically. Exports and tables from real systems
are pinned as artifacts and matched row by row into proposals; model
judgment is injected only where your pinned domain logic can't decide.

- Writes are governed. Governed relationships can only be written through
a proposal flow that requires declared evidence, auto-resolves only under
trust rules you set, and routes everything else to human review. Every
accepted claim is attributed and carries a receipt.

- The model is executable. Recurring procedures are declared workflows in
the same config: previewed before they apply, locked to the exact provider
code and artifacts they compile against, replayable from receipts. State
accumulates as the exhaust of governed work, and the model improves
iteratively: feedback and outcomes are recorded in state, and the config
evolves like code.

- Reads are reproducible. Same query, same state, same result, with a
receipt explaining how it was derived. Queries express structure that
retrieval can't: multi-hop traversals, review status, staleness against
cited sources.

- The core is deterministic. No LLM inside, no hidden API calls. It works
with any agent or harness, points at your existing systems, and mints into
state only the claims worth coordinating around.

Get Started

pip install cruxible

Model your own domain: hand your agent the authoring skills in
skills/
(prepare-datacreate-statereview-state) with your exports
(wiki-to-state converts an existing CLAUDE.md pile or Obsidian vault), or
start from Modeling State
and the config template.

Or run the demo — a seeded supply-chain world, ~3 minutes, no tokens
(sandbox writes attribute to a built-in operator identity):

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.