0gpc

Build on the trust layer for AI.

Intro

Use 0G Private Computer in your coding tools.

Requires macOS or Linux, Node.js 22+, and an installed coding tool.

Install or upgrade Node.js. If you already use nvm:

nvm install 22
nvm use 22

Integration

Currently supported coding tools:

• Claude Code
• OpenCode
• Pi
• Hermes Agent

OpenCode V2 and non-default Hermes profiles are not supported.

Features

• Guided setup — Connect your tool in a few steps.
• Model details — Compare providers, context and capabilities.
• Hidden key input — Enter your API key privately.
• Configuration preview — Review changes before saving.
• Reversible changes — Disconnect without removing unrelated settings.
• Connection management — Manage tools, models and keys.
• Optional verification — Confirm before paid checks or tool launch.
• Automation support — JSON output for scripts; no telemetry.

Quick Start

Get your 0G API key, then run:

npx @0xdragon888/0gpc@latest

Or install globally for the shorter 0gpc command:

# Install or upgrade
npm install -g @0xdragon888/0gpc@latest

# Start in your project directory
0gpc

Use ↑/↓ to navigate, Enter to confirm, and Ctrl-C to cancel.

Command list

The examples below use the global 0gpc command. Without a global install, replace it with npx @0xdragon888/0gpc@latest.

# Show help
0gpc -h
0gpc --help

# Show version
0gpc -v
0gpc --version

# Open setup or manage existing connections
0gpc

# API key management
0gpc key set                   # Save or replace a key using hidden input
0gpc key set --stdin           # Read a key from piped standard input
0gpc key rm                    # Remove an unused saved key

# Show connections
0gpc status
0gpc status --json             # Machine-readable output

# Health checks
0gpc doctor --offline          # Check local configuration
0gpc doctor --offline --strict # Fail on warnings as well as errors
0gpc doctor --network          # Verify access; may incur a charge

# Preview configuration (run from your project root)
0gpc apply claude --scope project --model <model-id> --dry-run

# Save configuration
0gpc apply claude --scope project --model <model-id> --yes

# Disconnect a tool; keep the saved key
0gpc reset claude --yes

Replace <model-id> with a compatible model ID. Tool IDs: claude, opencode, pi, hermes. Scopes: project or user; Pi and Hermes use user only.

JSON output uses schema_version: 3.

Configuration file

| Default path | Contents | |---|---| | ~/.config/0gpc/config.toml | Connections and preferences | | ~/.local/share/0gpc/keys/ | Saved API keys | | ~/.local/state/0gpc/ | Change records and backups |

Supports XDG paths and ZGPC_HOME for custom 0gpc storage.

| Tool | Default configuration files | |---|---| | Claude Code | Project: .claude/settings.local.json; user: ~/.claude/settings.json | | OpenCode V1 | Project: opencode.json or opencode.jsonc; user: under ~/.config/opencode/ | | Pi | ~/.pi/agent/models.json and ~/.pi/agent/settings.json | | Hermes Agent | ~/.hermes/config.yaml and ~/.hermes/.env |

MIT License · 0G CLI