Agent setup

Install the dvm skill and configure network egress for sandboxed coding-agent harnesses, covering Claude Code, Cursor, and Codex.

Coding-agent harnesses increasingly sandbox network access by default. Codex CLI ships with it off, Cursor's agent sandbox has been default-deny since 2.5, and Claude Code's opt-in sandbox tightens every release. If dvm can't reach the network, every command fails on a generic connection error with no hint why. This page has the exact config to add per harness, and the full list of domains dvmkit needs.

Install the skill

The CLI is the tool; the skill is the instructions for using it. Install the same public npm package for both before the first job. The CLI requires Node.js 22 or later and npm.

If you have not installed the CLI yet:

npm install --global @dvmkit/dvm-cli

Copy the complete bundled skill directory into your agent's skill directory. For Claude Code:

mkdir -p ~/.claude/skills
cp -R "$(npm root --global)/@dvmkit/dvm-cli/skills/dvm" ~/.claude/skills/

Keep the skill and CLI on the same package version. After npm update --global @dvmkit/dvm-cli, copy the skill again.

The example uses Claude Code's ~/.claude/skills/dvm/SKILL.md. Codex loads the entry file from ~/.codex/skills/dvm/SKILL.md (or $CODEX_HOME/skills/dvm/SKILL.md), while goose, OpenClaw, and other Agent Skills-compatible harnesses use ~/.agents/skills/dvm/SKILL.md. Only the destination differs; use the one your harness recognizes. Scope a skill to one project by putting it in that project's matching skill directory.

Configure network access

Add your harness's snippet below, then see domains to allowlist for what goes in it. Verified 2026-08-06 against each vendor's current docs. Sandboxing is a fast-moving area, so if something here doesn't match what you see, trust the linked reference over this page.

Claude Code

Opt-in: sandboxing does nothing until you enable it. Once enabled, network starts at zero allowed destinations. Add to .claude/settings.json (project) or ~/.claude/settings.json (user):

{
  "sandbox": {
    "enabled": true,
    "network": {
      "allowedDomains": [
        "*.dvmkit.ai",
        "api.dvmkit.dev",
        "mint.coinos.io",
        "mint.lnvoltz.com",
        "api.coingecko.com",
        "mainnet.base.org",
        "rpc.tempo.xyz"
      ]
    }
  }
}

If the domain is allowlisted and dvm still can't connect, check open sandbox-networking issues on anthropics/claude-code for Node.js processes specifically. There's a known DNS-resolution gap between what the sandbox proxy intercepts and Node's own resolver, and dvm is a Node CLI. Reference: code.claude.com/docs/en/sandboxing.

Cursor

Default-deny since 2.5 (Feb 2026), with three modes: allowlist only, allowlist plus Cursor's built-in defaults, or allow-all. Add to .cursor/sandbox.json (project-level):

{
  "networkPolicy": {
    "default": "deny",
    "allow": [
      "*.dvmkit.ai",
      "api.dvmkit.dev",
      "mint.coinos.io",
      "mint.lnvoltz.com",
      "api.coingecko.com",
      "mainnet.base.org",
      "rpc.tempo.xyz"
    ]
  }
}

Reference: cursor.com/docs/reference/sandbox.

Codex

Off by default. The blanket toggle is the fix that matters; add to ~/.codex/config.toml (or $CODEX_HOME/config.toml):

sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = true

To scope down to specific domains instead of opening network access entirely, layer a proxy rule on top. It has no effect without the toggle above, and an unlisted domain is denied by default:

[features.network_proxy]
enabled = true
domains = { "*.dvmkit.ai" = "allow", "api.dvmkit.dev" = "allow", "mint.coinos.io" = "allow", "mint.lnvoltz.com" = "allow", "api.coingecko.com" = "allow", "mainnet.base.org" = "allow", "rpc.tempo.xyz" = "allow" }

If your Codex version rejects the wildcard, list each DVM host explicitly (cast.dvmkit.ai, scribe.dvmkit.ai, etc.) or drop the proxy-rule block and rely on the blanket toggle alone. Reference: developers.openai.com/codex/concepts/sandboxing.

Working against the local stack? npm run dev:stack serves DVMs on localhost. Codex's allow_local_binding (off by default) blocks loopback and private-IP targets even for an allowlisted hostname that resolves there. That's irrelevant for calling production dvmkit endpoints, but you'll need it on to reach a local stack from inside the sandbox.

Domains to allowlist

DomainWhy
*.dvmkit.aiDVM endpoints: the first-party services (cast, narrate, scribe, scrape, discover) and any builder-qualified <handle>--<slug>.dvmkit.ai, all behind the router's single wildcard apex. Safe to wildcard broadly because it's one apex we control, not a shared hosting domain.
api.dvmkit.devPlatform API: wallet pairing, discovery fallback.
mint.coinos.io, mint.lnvoltz.comThe Cashu mints the first-party DVMs and platform run on, and the pair the funding guide tells a caller to add. A specific job's dvm quote can name a different mint; allowlist what it actually shows if so.
your NWC relayOnly if you've connected a Lightning float (dvm wallet connect / dvm wallet pair). Always provider-specific: dvmkit has no default relay, so read it out of your nostr+walletconnect:// connection string's relay param.
api.coingecko.comBTC/USD rate lookups behind fiat-denominated amounts (dvm wallet fund $5, dvm convert).
mainnet.base.orgOnly if you've connected an x402 wallet. Reads its balance and signs its withdrawal transactions on Base, the chain a wallet connects to by default. DVM_X402_RPC_URL moves the read somewhere else; a wallet pinned to another chain reaches that chain's own endpoint, which needs its own entry.
rpc.tempo.xyzOnly if you've connected a Tempo wallet. Reads its balance and signs dvm wallet tempo-exit. DVM_TEMPO_RPC_URL moves it.

Sandbox also blocking package installs? Add registry.npmjs.org to install the CLI and its bundled skill. No GitHub host is needed for installation.

Reading these docs programmatically

This site publishes /llms.txt (page index) and /llms-full.txt (full content). Pull either instead of navigating page by page.

Next steps

  • Quickstart: install the CLI, fund a wallet, make your first paid call.
  • dvm CLI reference: every command, flag, JSON shape, and error code.