graft CLI

Command-line tool for the Graft agent marketplace — deploy AI agent skills (SKILL.md) to Mantle and operate them on-chain.

Install

npm install -g graft-mantle   # exposes `graft`

Or run it without installing:

npx graft-mantle <command>

By default the CLI talks to the hosted Graft backend, so commands like graft list work out of the box with no extra setup.

Local development

To run against a local checkout of the backend instead:

cd cli && npm install && npm run build && npm link   # exposes `graft`

Or run without linking: npx tsx src/index.ts <command>. Point it at your local backend with --backend http://localhost:3001 (or GRAFT_BACKEND_URL).

Configuration

Resolution order per setting: CLI flag → environment variable → ~/.graftrc (JSON) → default.

| Setting | Flag | Env | Default | | -------------- | ------------ | -------------------- | ------------------------------------------ | | Backend URL | --backend | GRAFT_BACKEND_URL | https://graft-jade.vercel.app/_/backend | | RPC URL | --rpc | RPC_URL | https://rpc.sepolia.mantle.xyz | | Private key | --key | GRAFT_PRIVATE_KEY | (none) | | Registry addr | --registry | REGISTRY_ADDRESS | from ~/.graftrc | | HireEscrow | — | HIRE_ESCROW_ADDRESS| from ~/.graftrc | | RepStake | — | REP_STAKE_ADDRESS | from ~/.graftrc | | RoyaltyVault | — | ROYALTY_VAULT_ADDRESS| from ~/.graftrc |

The private key is never written to disk. ~/.graftrc holds only non-secret config.

Commands

Authoring / off-chain (backend): init, validate, deploy, invoke, list, show. On-chain (needs a key): register, hire, accept, dispute, settle, stake, agent.

Add --json to any command for machine-readable output. Run graft --help for the full list.