thyme-graph

thyme-graph is a Thyme wrapper around the Graph CLI.

The goal is simple:

• keep the Graph CLI feel for users already building subgraphs
• proxy standard Graph commands to the upstream CLI
• override auth and deploy so deployments go through Thyme

Current Status

The CLI is usable for development and internal testing.

What works today:

• auth stores a Thyme deploy key locally
• deploy builds to IPFS and submits the deploy to Thyme
• deploy --ipfs-hash reuses an existing manifest CID
• deploy --watch rebuilds and redeploys on changes
• non-overridden commands are proxied to the upstream Graph CLI

What is still evolving:

• the final Thyme backend API contract
• end-to-end behavior against the production Thyme service
• a few parity and polish items listed in PLAN.md

Install

npm install
npm run build

For local development:

npm run dev -- --help

Usage

Top-level help:

npm run dev -- --help

Auth:

npm run dev -- auth --help
npm run dev -- auth <DEPLOY_KEY>
npm run dev -- auth <DEPLOY_KEY> --node https://your-thyme-endpoint.example/deploy/

Deploy:

npm run dev -- deploy --help
npm run dev -- deploy my-subgraph/v1 subgraph.yaml
npm run dev -- deploy my-subgraph/v1 subgraph.yaml --version-label v0.0.1
npm run dev -- deploy my-subgraph/v1 subgraph.yaml --ipfs-hash <CID>
npm run dev -- deploy my-subgraph/v1 subgraph.yaml --watch

Compiled CLI:

node dist/index.js --help
node dist/index.js auth --help
node dist/index.js deploy --help

If the package is published, the intended UX is:

npx thyme-graph --help
npx thyme-graph auth --help
npx thyme-graph deploy --help

Command Model

Thyme-owned commands:

• thyme-graph auth
• thyme-graph deploy

Upstream pass-through commands:

• thyme-graph build
• thyme-graph codegen
• thyme-graph create
• thyme-graph test
• other Graph CLI commands that are not explicitly overridden

Notes

• Deploy keys are stored per normalized deploy endpoint.
• deploy uses the manifest CID as the canonical deployment hash.
• deploy --watch cannot be combined with --ipfs-hash.
• The current default deploy endpoint and IPFS endpoint are still product defaults and may change.

Credits

This project reuses and wraps the upstream Graph CLI:

• @graphprotocol/graph-cli
• graphprotocol/graph-tooling

Credit goes to the original Graph protocol tooling developers for the CLI, compiler flow, and developer experience this wrapper builds on top of.

thyme-graph does not replace that work. It extends it with Thyme-specific auth and deployment behavior.