Atlas Harness

A Windows-first, high-performance TypeScript JSON-RPC harness for agentic workspace operations. Built for AI agents to interact with the file system, shell, and Git with safety gates and observability.

Features

• JSON-RPC 2.0 Interface: Standardized communication over Stdiod, HTTP, or MCP.
• MCP Integration: First-class support for the Model Context Protocol.
• Safety Gates: Built-in rules engine (Regex & AST) to block or warn on dangerous operations.
• Drift Detection: Automatic detection of stale documentation based on file changes.
• Workspace Snapshots: Stash-based rollback points for safe experimentation.
• AST powered analysis: Deep code understanding using Tree-sitter.
• Observability: Detailed chat logging and action history.

Installation

bun install atlas-harness

Usage

Start the stdio server:

atlas-harness --transport stdio

Start the HTTP server:

atlas-harness --transport http --port 3000

MCP Configuration

Add to your cursor.json or claude_desktop_config.json:

{
  "mcpServers": {
    "atlas-harness": {
      "command": "bun",
      "args": ["run", "node_modules/atlas-harness/dist/index.js", "--transport", "mcp"]
    }
  }
}

License

MIT