autonome-mcp

Rust-based MCP server that gives Claude Desktop agency over wake, heartbeat, and federated task execution on macOS.

Features

• Wake and heartbeat messages to Claude Desktop via AppleScript.
• Launchd installers for scheduled wake/heartbeat with configurable times.
• SQLite state store (WAL) with graceful schema upgrades.
• Federated task queue with stdout/stderr/exit artifacts for inspection.

Quickstart

git clone <repo-url>
cd autonome-mcp
cargo build --release

Run the server

cargo run -- serve

The MCP server listens on stdio for Claude Desktop.

Initialize scheduling (macOS)

cargo run -- init --hour 1 --minute 0 --data-dir ~/.local/share/autonomy-mcp

Creates autonomy.db, installs launchd plist for daily wake, and enables heartbeat defaults.

Manual operations

• cargo run -- run-wake — send immediate wake message.
• cargo run -- run-heartbeat — send heartbeat if enabled.
• cargo run -- status — show persisted state and heartbeat config.
• cargo run -- test "MESSAGE" — ad-hoc AppleScript send for debugging.

Project Layout

• src/ — core modules (applescript, federation, launchd, mcp, state, tasks, main.rs).
• docs/ — design notes (FEDERATION-TOOLS-SPEC.md).
• scripts/ — helper automation (e.g., WakeClaude.applescript, build_trampoline.sh).
• target/ — build outputs.

Development

• Format: cargo fmt
• Lint: cargo clippy -- -D warnings
• Test: cargo test
• Release: cargo build --release

Coding style: Rust 2021, anyhow::Result for app flows, avoid unwrap in runtime paths, use tracing with context-rich fields.

Data & Safety Notes

• Default data dir: ~/.local/share/autonomy-mcp/autonomy.db. Override with --data-dir for tests.
• Launchd + AppleScript assume macOS with Claude Desktop installed; avoid running on unsupported hosts.
• Keep tokens and personal data out of logs; this project operates without embedding secrets.

Contributing

See AGENTS.md for contributor guidelines (structure, commands, style, testing, and PR expectations).