Skip to content
Skill

parchi-relay

by 0xSero

AI Summary

This skill documents how to run the Parchi relay daemon, connect the browser extension as an agent, and use the CLI to drive browser automation. 1. Build everything: 2. Start the relay daemon (terminal A):

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "parchi-relay" skill in my project.

Please run this command in my terminal:
# Install skill into your project
mkdir -p .claude/skills/parchi && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/parchi/SKILL.md "https://raw.githubusercontent.com/0xSero/parchi/master/SKILL.MD"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

Description

Use Parchi Relay to control a real browser via the Parchi extension agent (WebSocket) or directly via JSON-RPC from a CLI/tooling workflow.

CLI Usage (Real Commands)

The CLI talks to the daemon over HTTP JSON-RPC. Set env vars (recommended): `bash export PARCHI_RELAY_TOKEN="<YOUR_TOKEN>" export PARCHI_RELAY_HOST="127.0.0.1" export PARCHI_RELAY_PORT="17373" ` List agents: `bash npm run relay -- agents ` Doctor (sanity-check daemon, auth, agent connection, tool forwarding): `bash npm run relay -- doctor ` Get/set default agent: `bash npm run relay -- default-agent get npm run relay -- default-agent set agent-123 ` List tools (on default agent or a specific agent): `bash npm run relay -- tools npm run relay -- tools --agentId=agent-123 ` Call a tool: `bash npm run relay -- tool getTabs --args='{}' npm run relay -- tool getContent --args='{\"mode\":\"text\"}' ` Run a full agent task and wait for completion: `bash npm run relay -- run "On the active tab, extract the main headline." --tabs=active --timeoutMs=600000 `

Parchi Relay (How To Use It)

This skill documents how to run the Parchi relay daemon, connect the browser extension as an agent, and use the CLI to drive browser automation.

What You Get

• A local relay daemon (/v1/rpc + /v1/extension) that brokers calls. • A browser extension agent that connects to the daemon over WebSocket and executes browser tools. • A CLI (parchi-relay / npm run relay) that can: • list agents • pick the default agent • list tools / call tools • run an agent task and wait for completion

Quickstart (Local)

• Build everything: `bash npm install npm run build ` • Start the relay daemon (terminal A): `bash npm run relay:daemon -- --token=<YOUR_TOKEN> --host=127.0.0.1 --port=17373 ` • Load the extension (Chrome): • Open chrome://extensions • Enable Developer mode • Load unpacked: dist/ • Open the extension sidepanel • Settings -> Relay: • Enable: On • URL: http://127.0.0.1:17373 • Token: <YOUR_TOKEN> • Click Apply • Confirm the agent is connected (terminal B): `bash npm run relay -- agents --token=<YOUR_TOKEN> `

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 3d ago
Active
Adoption100+ stars on GitHub
484 ★ · Growing
DocsREADME + description
Well-documented

GitHub Signals

Stars484
Forks47
Issues15
Updated3d ago
View on GitHub
MIT License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code