Skip to main content

Documentation Index

Fetch the complete documentation index at: https://ade-app.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

Connecting a Backend

Ghost OS Setup

1

Install Ghost OS

Download and install the Ghost OS CLI for macOS from ghostos.dev, then run ghost setup to grant the required macOS permissions.
2

Verify the CLI

Run ghost status and ghost doctor in Terminal. ADE uses those commands to detect whether Ghost OS is installed, ready, or blocked by stale processes.
3

Verify connection

Open Settings → Computer Use. The Ghost OS card should show a ready state with the capability matrix populated. If it shows an error, rerun ghost setup or follow the doctor output.
4

Set as preferred backend

In Settings → Computer Use → Preferred Backend, select Ghost OS. ADE will use Ghost OS for all computer-use requests until you change this setting.

agent-browser Setup

1

Ensure Node.js 18+ is installed

Run node --version to confirm. If needed, install via nodejs.org or brew install node.
2

Add to ADE configuration

Install the agent-browser CLI so it is available on PATH; ADE detects it with agent-browser and ingests the artifacts it produces.
3

Verify connection

Open Settings → Computer Use. The agent-browser card should show Ready. On first use, ADE will download the @agent-browser/cli package automatically.

Computer Use Policies

Each chat session and mission has a computer-use policy header that controls when the agent is allowed to invoke computer-use tools. Set the policy at session start or change it mid-session from the chat header bar.
PolicyBehavior
CU OffComputer use tools are never available in this session. Agents cannot invoke them even if they try.
CU AutoADE decides when computer use is appropriate based on the task. The agent does not choose directly.
CU OnComputer use tools are always available. The agent decides when to invoke them.
FallbackThe agent attempts the task without computer use. If it cannot complete the task, it falls back to CU.
ProofComputer use is available, but every action must produce a proof artifact. The session blocks if proof is missing.
Use Proof mode for any automation that will be shared with stakeholders or linked to a Linear issue. The collected artifacts provide an auditable record of exactly what the agent did.