Chio·Surfaces·Plugins
Claude Code · Plugin 01

Claude Code plugin

Talk Claude into building you a tiny hedge fund.

The plugin turns any Claude Code session into a bonded operator. Bind a capability, run /chio:bond, and every tool Claude reaches for, from the filesystem to your broker, is mediated, metered, and settled against a signed receipt.

surfaceClaude Code 0.3+runtimechio 0.1.0 · bridge 0.2.1installclaude plugin add @chio-protocol/claude-code-pluginsourcebackbay-labs/chio-claude-code-plugin
Claude Code · livecapability bonded
>build me a tiny hedge fund that can place orders on alpaca, cap me at $500, and email a receipt when it's done
claude drafting plan, requesting capability cap_trader
chio attenuating → ttl 20m, budget $500.00, egress paper-api.alpaca.markets
guard pipeline7 / 7
place_order · BUY 6 SPY @ market · filled in 112ms
place_order · BUY 3 QQQ @ market · filled in 140ms
·budget $148.20 / $500.00 · receipts streaming to chio trust serve :8940
Receipt0x8a4f…c2b1ed25519 ✓
01Install

Three lines. One bonded Claude.

The plugin ships as an npm package Claude Code can load directly. Install the runtime, add the plugin, point it at a policy, and Claude will route every tool invocation through Chio, without knowing it.

01

Install the chio runtime

The chio binary handles the kernel; trust plane serves on :8940.

$curl -fsSL https://www.chio.world/install.sh | sh && chio trust serve
02

Add the plugin to Claude Code

Registers /chio:* commands and the PreToolUse/PostToolUse hooks that route every tool call through chio.

$claude plugin add @chio-protocol/claude-code-plugin
03

Bond a capability

Issues an Agent Passport scoped to the policy. Every tool call is mediated against it.

$/chio:bond ./hedge.policy.yaml 4h
agent: claude-session-a9e3 · budget: $500 · guards: 7
# HushSpec 0.1.0 · tiny hedge fund, bonded to Claude Code.
hushspec: "0.1.0"
name: tiny-hedge-fund

rules:
  tool_access:
    enabled: true
    default: block
    allow:
      - place_order
      - read_prices
      - email_receipt

  egress:
    enabled: true
    default: block
    allow:
      - https://paper-api.alpaca.markets

  velocity:
    budget_usd: 500
    max_invocations: 40
    window_seconds: 3600

  human_in_loop:
    approve_above_usd: 150
02How it works

The loop. From a prompt to a receipt.

Every tool Claude reaches for, whether Bash, Write, Edit, Read, or any mounted MCP server, takes the same path. The plugin is just the surface; the chio kernel is underneath.

01 · Intent

Claude proposes a tool call.

The PreToolUse hook snaps the call before it leaves the sandbox. Args are normalized; MCP tools are decomposed into (serverId, tool).

place_order {symbol:SPY, qty:6}
02 · Mediate

Chio runs the pipeline.

Capability, 18 guards, budget, and velocity: fail-closed, single pass, ~2ms median.

18 guards · 1.8ms
03 · Act

Tool executes or is denied.

An allow turns into the actual call. A deny surfaces in chat with a human-readable reason and the guard that refused.

decision: allow
04 · Commit

Receipt is signed.

One ed25519-signed artifact per call. Merkle-committed; streamed to your SIEM; available via /chio:receipt-last.

ed25519:e5f6a7b8…
03Features

More than a shim. A whole co-pilot.

The plugin folds Chio primitives directly into the conversation. Capabilities, budgets, approvals, and evidence become first-class citizens of the Claude workflow.

Bonded sessions

Every chat becomes an Agent Passport with a scoped capability, a budget, and a TTL. Revoke from anywhere; remote rotations hit in <1s.

capabilities
$

Budget meters

Token, dollar, and invocation budgets inline in the chat. Claude sees the remaining runway and narrows scope on its own as it burns down.

velocity · cost

Human-in-loop gates

Flag tool calls that need a human. Claude pauses, posts a card, and won't proceed until you /chio:approve with your own signing key.

gates

Live guard edit

Pause, swap, or scope-shrink any of the 18 guards without leaving the chat. Every change is countersigned and receipted.

policy

Tool store

Browse and mount any MCP server the plugin has bonded. Chio attenuates the scope automatically to match the current policy.

mcp

Evidence export

/chio:receipt-export turns any slice of the session into an offline-verifiable bundle. Drop it in a ticket; verify without running Chio.

audit
04Recipes

Start with a sentence. Ship a citizen.

Paste these into any Claude Code session with the plugin installed. Every recipe binds a fresh capability, runs inside its own budget, and emits a signed receipt bundle when it's done.

traderRun a paper-trading book against Alpaca for 20 minutes. Cap me at $500. Summarize P&L and email me the receipt.18 guards · ttl 20m · budget $500~6 min
researcherRead every PDF in ./inbox, summarize, and write the summaries into Notion. Never touch anything else.fs-readonly · notion-write · egress notion~3 min
sreFollow this runbook, roll back the deploy, and ping me before each destructive step.human-in-loop · kubectl-attenuated~8 min
supportAnswer this inbox until it's empty. If a refund is >$100, pause for me. Everything goes to the audit log.mcp/zendesk · refund-gate $100~14 min
05Proof

Every step, countersigned.

allowplace_order · SPY × 6 @ market · $412.04 filled10:31:02
allowread_prices · QQQ, SPY, IWM (15m bars)10:31:04
cancelplace_order · COIN × 50 · blocked by budget cap10:31:06
allowemail_receipt · to: trader@example.com · 1 attachment10:31:07
denyshell.exec · `rm -rf ./state` blocked by forbidden_paths10:31:09

The plugin streams receipts as they're produced. Signed locally, Merkle-committed to the trust control plane, and ready to be exported to any SIEM or auditor. The session above produced 12 receipts in under a minute; the first five are shown here.

agentdid:chio:9f2c0a4e1b3c7d8e5f6a7b8c9d0e1f2a3b4c5d6e7f8091a2b3c4d5e6f7081234policytiny-hedge-fund@1.0.2count12 receipts · 10 allow · 1 deny · 1 cancelhash0x8a4f…c2b1

Bond Claude. Give it a budget. Get a receipt.

Install the plugin, point it at a policy, and Claude Code becomes the operator, not the liability. Four minutes to a working, signed, revocable agent.