ART — Agent Recall Trail

ART is a local-first memory and reviewed-knowledge product for coding agents. Every Agent gets a physically separate private Recall Trail. Stable conclusions become human-reviewed, immutable Knowledge Editions that other Agents can retrieve without seeing private source identities or source bodies.

ART 0.2.0 supports Codex and DeepSeek Harness (DSH) over stdio MCP. It is standalone: no AAA adapter, HTTP service, daemon, cloud sync, vector service, or autonomous publication is required.

Product boundary

• Private memory belongs to one process-bound Agent identity.

• Shared knowledge contains only committed, reviewed Editions.

• Agents may capture, recall, read, provide feedback, and create proposals.

• Only a local human may approve, publish, revoke, supersede, archive, or make assurance decisions.

• Stored content is evidence, never executable instruction or authorization.

Related MCP server: Engineering Knowledge Graph MCP Server

Quick start

cargo build --release --locked
./target/release/art --home /an/explicit/art-home init --confirm
./target/release/art --home /an/explicit/art-home agent create --id codex-primary --host codex
./target/release/art --home /an/explicit/art-home doctor --agent codex-primary --json

Use Codex integration or DSH integration to start one bound stdio child. Run art --help for the operator CLI.

Install

Download the native archive and SHA256SUMS from the latest release, verify the archive, then run the included installer with the extracted binary:

bash scripts/install.sh --binary /absolute/path/to/art --confirm
art --version
art doctor --agent codex-primary --json

The installer keeps executable bytes under ~/.across/bin/art, creates a discovery link at ~/.local/bin/art, and initializes owner-only ART data. It does not edit Codex or DSH configuration. The thin Codex plugin lives under plugin/agent-recall-trail; its MCP child is permanently bound to codex-primary. See operations before migrating or publishing knowledge.

ART 0.2.0 adds BM25-first fusion, bounded result depth, and reproducible BEIR retrieval gates while preserving deterministic Knowledge Vault backup, encrypted recovery of local review authority, and verified empty-home restoration. See operations before creating the dedicated private Git repository.

Configuration precedence is --home, then --config <file>, then the owner-only user config at ~/.across/config/art/config.json, then the built-in ~/.across root. ART config accepts only schema and home; credentials are deliberately unsupported.

Documentation

• Architecture

• Memory and knowledge model

• Operations

• Security model

• Testing and acceptance

• Architecture decisions

• Independent design review

All automated or manual tests must use an explicit task-owned ART home. ART never modifies Codex or DSH configuration automatically.

Apache-2.0 licensed. See Security, Contributing, and Support.