@0xdragon888/0gpc

0gpc

Build on the trust layer for AI.

Intro

Use 0G Private Computer in your coding tools.

Requires macOS or Linux (Windows is not supported), 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.

Security

• Your key stays private — Enter it with hidden input or --stdin. It is saved in 0gpc's own key store (~/.local/share/0gpc/keys/, readable only by you) and is never printed, logged or included in JSON output.
• Only 0gpc's own fields change — Interactive setup shows the configuration changes before saving; for scripts, apply --dry-run previews and apply --yes writes. key set saves the key at once and also updates the tool configurations already connected to it (for example the Hermes .env entry, or the base URL when the endpoint changes); it has no separate preview. Files are backed up and written atomically, unrelated settings are kept, and reset restores the values you had before.
• No paid checks without your consent — Listing models does not verify your key. Verification sends one minimal request only when you confirm it in setup, run key set --verify, or run doctor --network.
• Nothing runs behind your back — No telemetry and no automatic update checks. 0gpc shows install or update commands for you to run; it never runs them itself.

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

Supports XDG paths and ZGPC_HOME for custom 0gpc storage.

---

MIT License · 0G CLI