Agent Skills › rcarmo/piclaw › remote-peer

remote-peer

GitHub

用于管理远程 Piclaw 对等节点，包括列出节点、发送经 Ed25519 签名的提示词以及处理传入的执行提案（接受或拒绝）。支持按权限配置路由和批量决策。

runtime/skills/builtin/remote-peer/SKILL.md rcarmo/piclaw

Trigger Scenarios

用户要求与远程代理通信用户要求查询或管理已配对的远程节点用户要求处理待处理的远程执行提案

Install

npx skills add rcarmo/piclaw --skill remote-peer -g -y

More Options

Non-standard path

npx skills add https://github.com/rcarmo/piclaw/tree/main/runtime/skills/builtin/remote-peer -g -y

Use without installing

npx skills use rcarmo/piclaw@remote-peer

指定 Agent (Claude Code)

npx skills add rcarmo/piclaw --skill remote-peer -a claude-code -g -y

安装 repo 全部 skill

npx skills add rcarmo/piclaw --all -g -y

预览 repo 内 skill

npx skills add rcarmo/piclaw --list

SKILL.md

Frontmatter

{
    "name": "remote-peer",
    "description": "Send prompts to paired remote piclaw peers, list peers, and manage incoming proposals (pending\/accept\/reject). Uses Ed25519 signing to authenticate requests over HTTP. Use when asked to message, query, or manage remote agents.",
    "distribution": "public"
}

Remote Peer

Send signed prompts to paired remote piclaw peers and manage incoming proposals.

Helper script

All operations go through peer.ts (auto-resolved relative to this skill directory).

bun /workspace/piclaw/runtime/skills/builtin/remote-peer/peer.ts <command> [args]

CLI overrides

Flag	Purpose
`--store-dir <dir>`	Override `PICLAW_STORE` for DB location
`--data-dir <dir>`	Override `PICLAW_DATA` for identity/IPC location

Commands

List all peers

bun peer.ts list

Output: <name> | <fingerprint> | <status>/<mode>/<profile> | <base_url>

Send a prompt to a peer

bun peer.ts send <peer> "<prompt>"

<peer> can be:

fingerprint: cad6It-SMYlIb-mIdw8c
display name: product-manager
instance_id prefix

Routing is automatic:

full / short-circuit peers → /api/remote/execute (synchronous, returns result)
all others → /api/remote/proposal (queued, requires human approval on their side)

Permission profiles (set via /pair permissions):

read-only — ping/status only; proposals and execution are rejected
non-mutating — all read-only tools (no side-effects); mutating tools blocked
restricted (default) — denylist-based; shell, file-write, keychain, etc. blocked
full — unrestricted tool access

Examples:

bun peer.ts send product-manager "What is your current task?"
bun peer.ts send cad6It-SMYlIb-mIdw8c "Summarise the agenda-inovar repo"

Show pending incoming proposals

bun peer.ts pending

Decide on a single proposal

bun peer.ts decide <request-id> accept
bun peer.ts decide <request-id> reject

accept: writes an IPC task file that triggers the runtime to execute the proposal through the agent pool. The runtime handles execution, stores the result, and pushes a signed result callback to the requesting peer. Equivalent to /pair approve <id>.
reject: writes an IPC task file that triggers the runtime to reject the proposal. The runtime handles the DB update and pushes a signed rejection callback (decision: "deny") to the requesting peer's /api/remote/result endpoint. Equivalent to /pair reject <id>.

Bulk-decide all pending proposals

bun peer.ts decide-all accept
bun peer.ts decide-all reject

Same semantics as decide but applied to every pending proposal at once.

accept: queues all pending proposals for execution via IPC task files.
reject: queues all for rejection via IPC task files; the runtime pushes rejection callbacks to each requesting peer.

Environment

The script reads these env vars. CLI flags can override them:

Var	Default	Purpose
`PICLAW_DATA`	`/workspace/.piclaw/data`	Identity key location
`PICLAW_STORE`	`/workspace/.piclaw/store`	SQLite DB location

piclaw's bash tool injects these automatically when available.

How it works

Loads identity from $PICLAW_DATA/interop/identity.json
Looks up the peer's base_url, mode, profile, and trust_epoch from the SQLite DB
Builds a canonical request string and signs it with the local Ed25519 private key
POSTs to /api/remote/execute (short-circuit peers) or /api/remote/proposal (mediated peers)
Returns the peer's response inline