@gitnullxyz/gnull

v0.3.1

Published

25 days ago

GitNull CLI: onchain-native git collaboration with DID identity, IPFS mirrors, AI agents, and installable agent skills

0High
0Medium
0Low

gitnullxyz

git onchain ipfs did web3 blockchain gitnull gitlawb ucan libp2p mcp

gnull - GitNull CLI

 ██████╗ ██╗████████╗███╗   ██╗██╗   ██╗██╗     ██╗     
██╔════╝ ██║╚══██╔══╝████╗  ██║██║   ██║██║     ██║     
██║  ███╗██║   ██║   ██╔██╗ ██║██║   ██║██║     ██║     
██║   ██║██║   ██║   ██║╚██╗██║██║   ██║██║     ██║     
╚██████╔╝██║   ██║   ██║ ╚████║╚██████╔╝███████╗███████╗
 ╚═════╝ ╚═╝   ╚═╝   ╚═╝  ╚═══╝ ╚═════╝ ╚══════╝╚══════╝

onchain-native git · DID identity · IPFS mirrors · AI agents · agent skills

gnull is the official command-line interface for the GitNull platform: onchain-native code collaboration built on IPFS, libp2p, DID:key identities, autonomous AI agents, and installable agent skills.

Install

npm install -g @gitnullxyz/gnull

Quick Start

gnull                        # show banner + commands
gnull repo list              # list repositories
gnull repo info owner/name   # repo details + IPFS hash
gnull pr list                # list pull requests
gnull pr merge 42            # merge PR onchain
gnull issue list             # open issues with bounty amounts
gnull bounty list            # $GNULL bounty board
gnull node status            # live gitlawb network status
gnull whoami                 # show DID identity
gnull config set --api-url https://gitnull.xyz/api

Agent Skills

Skills are installable capability modules for your GitNull agent. Install a skill and your agent gains new tool calls and domain expertise for that area. Your repo's skill.md is the lock file: it lists every installed skill and its version.

# Browse the skill registry
gnull skill list

# Install a skill (adds to skill.md in current directory)
gnull skill install @gitnull/skill-security
gnull skill install @gitnull/skill-bounty
gnull skill install @gitnull/skill-review

# Install a pinned version
gnull skill install @gitnull/[email protected]

# Show installed skills for current repo
gnull skill show

# Update all skills to latest
gnull skill update

# Check what's outdated
gnull skill diff

# Validate skill.md
gnull skill validate

# Remove a skill
gnull skill uninstall @gitnull/skill-security

# Build and publish your own skill
gnull skill scaffold my-skill --author 0xYourWallet
gnull skill publish

Available Skills

| Package | Description | |---------|-------------| | @gitnull/skill-security | Deep security scanning: Solidity, secrets, CVEs, auth routes | | @gitnull/skill-bounty | Bounty prioritization, feasibility ranking, work plans | | @gitnull/skill-review | PR review: type safety, error handling, test coverage | | @gitnull/skill-refactor | Dead code, duplication, refactor opportunity detection | | @gitnull/skill-docs | README, JSDoc, NatSpec documentation generation | | @gitnull/skill-triage | Issue labeling, deduplication, stale issue flagging |

Full registry: https://gitnull.xyz/skills

skill.md format

# skill.md - installed agent skills
# Manage with: gnull skill install / uninstall / update

skills:
  - package: "@gitnull/skill-security"
    version: "1.2.0"

  - package: "@gitnull/skill-bounty"
    version: "2.0.1"

AI Agent (openclaude integration)

gnull agent integrates with openclaude using the GitNull API as an OpenAI-compatible AI gateway.

# Launch openclaude with GitNull AI backend
gnull agent run

# Launch with repo context pre-loaded
gnull agent run owner/repo-name

# Write .openclaude.json for this directory
gnull agent init

# List all repository agents
gnull agent list

# Show supported model providers
gnull agent providers

# Trigger a security scan
gnull agent restart owner/repo-name

When you run gnull agent run, it:

Checks if openclaude is installed (installs if not)
Configures openclaude to use the GitNull API as its OpenAI-compatible backend
Pre-loads repository context into the agent system prompt
Loads skills from skill.md if present
Launches openclaude

The agent falls back to Gitlawb Opengateway (free, no API key) if no provider is configured.

Configuration

Config is stored at ~/.gnull/config.json.

gnull config show
gnull config set --api-url https://gitnull.xyz/api
gnull config set --did did:key:z6Mk...
gnull config set --token your-api-token

Or use env vars:

export GNULL_API_URL=https://gitnull.xyz/api

gitlawb Integration

GitNull is part of the gitlawb decentralized git ecosystem:

Every repo push is pinned to IPFS via gitlawb nodes
DID:key identities are cross-compatible with the gitlawb network
AI agents run as MCP-compatible processes on the shared libp2p mesh
gnull node status shows live health of all gitlawb nodes

gnull node status            # live node ping + DID + protocols
gnull repo mirror owner/repo # pin repo to gitlawb IPFS

Network

Default API endpoint: https://gitnull.xyz/api

gitlawb nodes:

node.gitlawb.com - primary (DID, P2P, protocols)
node2.gitlawb.com - replica
node3.gitlawb.com - replica

License

MIT