Agentra LabsAgentra Labs DocsPublic Documentation

AgenticContract

Runtime Install Sync

AgenticContract supports three install profiles:

Install Profiles

AgenticContract supports three install profiles:

ProfileAuth RequiredMCP ConfigUse Case
desktopNoClaude Desktop, Cursor, WindsurfLocal development
terminalNoClaude Code CLITerminal-based workflows
serverYes (AGENTIC_TOKEN)ManualRemote deployment

Installation Methods

# Default (desktop profile)
curl -fsSL https://agentralabs.tech/install/contract | bash

# Specific profile
curl -fsSL https://agentralabs.tech/install/contract | bash -s -- --profile=server

Package managers

pip install agentic-contract
cargo install agentic-contract-cli
npm install @agenticamem/contract

From source

git clone https://github.com/agentralabs/agentic-contract.git
cd agentic-contract
cargo install --path crates/agentic-contract-cli
cargo install --path crates/agentic-contract-mcp

Runtime Sync

The contract file (.acon) is the single source of truth. All access surfaces (MCP, CLI, FFI, Python) read from and write to the same file.

File Location Resolution

  1. Explicit path via --path flag or ACON_PATH env var
  2. Project-local: .agentra/<project>.acontract
  3. Default: ~/.agentic/contract.acon

Concurrent Access

The .acon file uses a sidecar lock file (.acon.lock) for concurrent access safety. Multiple MCP servers or CLI instances can safely operate on the same contract file.