Install the Praesia CLI and MCP server by hand

Your agent installs Praesia by itself, as the Quickstart shows. Use this page when your harness stops it, for example by refusing a command or by blocking a change to its settings. Do only the steps your agent couldn’t finish, then hand back. Your agent runs everything after that. A hosted assistant, such as Dot or Grok Bot, runs the install by itself.

In auto mode, Claude Code can block some of these commands. Run them yourself in a terminal, or run /permissions in Claude Code and allow them.

What you need

Item	Where it comes from
CLI download link	The text at your skill link
Skill link	Your invite
macOS or Linux	WSL (Windows Subsystem for Linux) is experimental for now.
Node.js 22.18.0 or later	nodejs.org. Run `node --version` to check.

Install

Install the CLI

Open your skill link and copy the download link from its text, then check the install:

npm install -g 'DOWNLOAD_LINK'
praesia request --help

The check prints the usage of the sign-in command, for example:

Usage: praesia request --name NAME [--profile NAME] [--invite CODE] ...
Asks Praesia for the sign-in link of this agent, and prints the link ...

If npm fails with EACCES, run the install again with sudo in front.

Save the skill

The skill tells your agent how to use Praesia. Use the skill link from your invite.

Claude Code
Codex CLI
OpenCode
OpenClaw
Another harness

curl -fsS --create-dirs \
  -o ~/.claude/skills/praesia/SKILL.md \
  'SKILL_LINK'

curl -fsS --create-dirs \
  -o ~/.agents/skills/praesia/SKILL.md \
  'SKILL_LINK'

curl -fsS --create-dirs \
  -o ~/.agents/skills/praesia/SKILL.md \
  'SKILL_LINK'

curl -fsS --create-dirs \
  -o ~/.agents/skills/praesia/SKILL.md \
  'SKILL_LINK'

If OpenClaw runs with OPENCLAW_STATE_DIR set, save the skill there instead:

curl -fsS --create-dirs \
  -o "${OPENCLAW_STATE_DIR:?}"/skills/praesia/SKILL.md \
  'SKILL_LINK'

Your harness may not read this folder.

curl -fsS --create-dirs \
  -o ~/.agents/skills/praesia/SKILL.md \
  'SKILL_LINK'

Add the Praesia server

Add the server once for each machine. Run this block, then the command for your harness in the same terminal.

SERVER_COMMAND=$(praesia server-command |
  node -p 'JSON.parse(require("fs").readFileSync(0)).command')
SERVER_FILE=$(praesia server-command |
  node -p 'JSON.parse(require("fs").readFileSync(0)).args[0]')

Claude Code
Codex CLI
OpenCode
OpenClaw
Another harness

claude mcp add --scope user praesia -- \
  "$SERVER_COMMAND" "$SERVER_FILE" serve

If the server already exists, run claude mcp remove --scope user praesia, then add it again.

codex mcp add praesia -- \
  "$SERVER_COMMAND" "$SERVER_FILE" serve

Run opencode --version to pick the command.

OpenCode 2 or later

opencode mcp add praesia --global -- \
  "$SERVER_COMMAND" "$SERVER_FILE" serve

OpenCode 1

opencode mcp add praesia -- \
  "$SERVER_COMMAND" "$SERVER_FILE" serve

Stop the local OpenClaw Gateway first, because OpenClaw can’t change a saved server while it runs.

openclaw mcp add praesia \
  --command "$SERVER_COMMAND" \
  --arg="$SERVER_FILE" \
  --arg=serve

If the server already exists, run openclaw mcp unset praesia, then add it again.

Any harness that can use MCP can connect this way. Run praesia server-command. In the MCP (Model Context Protocol) configuration of your harness, put the line that it prints as the praesia entry:

{
  "mcpServers": {
    "praesia": {"command": "...", "args": ["...", "serve"]}
  }
}

Check the browser tool

Your agent reads the checkout page and types the card with a browser tool. If your harness gives it one, skip this step. Otherwise, we recommend agent-browser.

npm install -g agent-browser@0.39.1
agent-browser install

If the install fails

Error	Fix
`EACCES`	Run the same command with `sudo` in front.
`EBADENGINE` (a warning about the Node version)	Go on. Install no other Node.
`error while loading shared libraries` (Linux)	Run `agent-browser install --with-deps`.
`No usable sandbox!` (Linux)	Run the sandbox command below.

Ubuntu limits user namespaces, and Chrome needs them for its sandbox. This command adds an AppArmor profile that allows them only for agent-browser’s Chrome, at ~/.agent-browser/browsers/chrome-*/chrome. Your other programs don’t change. A process of your user that writes a file at that path also gets this permission.

sudo tee /etc/apparmor.d/praesia-agent-browser >/dev/null <<EOF
abi <abi/4.0>,
include <tunables/global>

profile praesia-agent-browser $HOME/.agent-browser/browsers/chrome-*/chrome flags=(unconfined) {
  userns,
  include if exists <local/praesia-agent-browser>
}
EOF
sudo apparmor_parser -r /etc/apparmor.d/praesia-agent-browser

To undo it:

sudo apparmor_parser -R /etc/apparmor.d/praesia-agent-browser
sudo rm /etc/apparmor.d/praesia-agent-browser

Hand back to your agent

Start a new session or restart the current one, so that the Praesia tools appear, then send this message. Your agent picks up from the sign-in, then interviews you for your first mandate.

Set up Praesia.

If your harness doesn’t read the saved skill, send this message instead:

Read SKILL_LINK and set up payments.

If it has no shell, send this message with your invite code:

Enroll with Praesia. My invite code is INVITE_CODE.

Get started

CLI

Help

Install the Praesia CLI and MCP server by hand

What you need

Install

​What you need

​Install

What you need

Install