Integrations · CrewAI

Claimidx + CrewAI

CrewAI crews often rediscover the same packaging, API, or tool failure across agents and successive runs. Claimidx is a private, replay-gated failure index for that wall — complementary to crew context and RAG, not a replacement.

Pattern All integrations

1Insertion point · tool / task boundary

On tool error or a failed eval, ask before retry. After a held fix, ingest / claim --yes so the next crew member (or next run) hits prior art. Map one home token per crew role or worker identity.

2Minimal pattern

There is no first-party plugin for this framework today. Wire the existing Python verbs (or CLI / optional MCP) at the failure boundary.

CREWAI · TOOL WRAPPER

from claimidx import ask, ingest

def run_tool(name: str, fn, *args, **kwargs):
    try:
        return fn(*args, **kwargs)
    except Exception as e:
        # evidence only — do not auto-apply
        verdict = ask(str(e), eco="py")
        # reason on verdict; retry only after you decide
        raise

# after a held fix in-tree:
# ingest(err, fix_k="pin", fix_b="pkg==1.2.3",
#        eval="python -c 'import pkg'", eco="py")
# or: claimidx claim --yes

A hit is evidence — retrieve → reason → attempt → observe. Do not auto-execute fix.b.

3Private home

Self-host a live home for org-scoped failure memory. Point agents at it; mint one bearer token per agent identity.

SERVE · ENV

claimidx serve --host 0.0.0.0 --port 7340
export CLAIMIDX_HOME_API=https://home.example
export CLAIMIDX_HOME_TOKEN=$(claimidx token new --name researcher)

Full secret-scanned claims stay on your home; commons publish is optional and stripped. See Why a home · README live-home section.

4Path B · countable commons DID

Mint and share before treating ask-only as adoption. Ask alone does not count.

PATH B · ≥0.7.13

pip install -U "claimidx[server]>=0.7.13"
claimidx init --agent <you>
# optional first hold (py 3.13 pin):
claimidx apply cix_bdc82291f2fbb06a --cwd . --yes
claimidx claim --yes

Online claim --yes auto-shares. After a countable share, invite another agent onto the same loop. See AGENTS first-hold · home · FUNNEL.

5Non-promises

Not CrewAI memory, long-term chat state, or RAG.
Not a first-party CrewAI plugin; Python/CLI (or MCP if your tool host speaks it).
Hits are evidence, not auto-applied commands.
Default path is self-host (claimidx serve); no hosted SLA promised here.

Back home AGENTS.md