RU Download
CONTINUOUS INTELLIGENCE CYCLE

From Intent to Real-World Effect

Mercury governs the complete closed loop between AI reasoning and physical macOS and mobile environments with refusal by default when identity, authority or the outcome of a past action is unknown, and a local operations log.

AI CLIENTS ChatGPT (tested) Claude (tested) Other MCP clients MERCURY GOVERNED CONTROL PLANE 1. Client Identity & Scopes clientId · 0600 token · sessions 2. Screen Lock Screen lock · 3 s wait · 10 s hold 3. Durable Effects & Idempotency idempotencyKey · replay cache · UNCERTAIN recovery 4. Local Operation Log (JSON Lines) Local JSONL · client · tool · duration · outcome TARGET PLATFORMS macOS Host Driver • argv-safe process exec • filesystem operations • screen inspection & AppleScript Mobile Drivers • Android ADB shell & input • iOS / iPadOS device listing Continuous Feedback Loop
01 / SENSE

1. SENSE

Perception layer: captures displays, file structures, and connected Android/iOS hardware status.

02 / UNDERSTAND

2. UNDERSTAND

Governance & context: validates per-client identity, enforces capability scopes, and coordinates screen actions that pass through Mercury.

03 / ACT

3. ACT

Governed execution: commands run as explicit argument lists, file operations, AppleScript, and adb device actions.

04 / FEEDBACK

4. FEEDBACK

Feedback: writes each call to the local operations log, refuses to repeat an action whose outcome is unknown (UNCERTAIN), and returns the result to the AI.

PHILOSOPHY

Philosophy

TWO NATURES. ONE SYSTEM. ONE REALITY.

AI systems reason, plan and request actions. Mercury is the layer that acts on the machine: the eyes, ears and hands of AI in the real world.

Mercury is not the brain. Decisions, memory and business orchestration stay with the AI and the people who use it; Mercury authenticates, authorizes, executes and records what happens on the device.