@levdomasnih/agent-relay-core

Core project-local state, locking, handoff, verification, and git attribution logic for Agent Relay.

Use this package when you want to embed coordination into a custom CLI, MCP server, agent runtime, or repository automation.

npm install @levdomasnih/agent-relay-core

import { AgentCoordinator } from "@levdomasnih/agent-relay-core";

const coordinator = new AgentCoordinator(process.cwd());
await coordinator.init("my-project");
await coordinator.createTask({
  title: "Refactor checkout flow",
  scope: "frontend",
  filesGlobs: ["src/checkout/**"],
});

What It Provides

• JSON-backed project state with lock-file protected writes.
• Stable machine task ids plus human-friendly display ids.
• Lease-based claims, lock modes, handoffs, and agent presence.
• Directed messages, inbox read receipts, and watch streams.
• Worktree and commit-range verification against task scopes.
• State schema migration helpers with backup creation.

Related Packages

• @levdomasnih/agent-relay-cli for terminal workflows.
• @levdomasnih/agent-relay-mcp-server for Codex, Claude, Cursor, and other MCP clients.

Full documentation: https://github.com/LevDomasnih/agent-relay#readme