CLI

Install & login

Install the graphon CLI and sign in with your Graphon account.

What it is

graphon is the Spark command-line client. It calls the Spark API and the G4 storage API as the signed-in user. Use it to manage workspaces, members, keys, buckets, and objects from a terminal or a script.

Install

Build the CLI from the workspace and run the bundled entry with node.

Build

pnpm --filter @spark/cli build
node packages/spark/cli/dist/main.js --help

You can also build a single-file native binary named graphon.

Binary

pnpm --filter @spark/cli build:binary
./packages/spark/cli/dist/graphon --help

Sign in

graphon login opens your browser to approve the login, then stores a refresh token on your machine. Use --device on a machine with no browser.

Login

graphon login
# On a headless machine, use the device flow:
graphon login --device

No stored secret in your code

The CLI stores its tokens under your config directory, not in your project. Confirm the login worked with whoami.

Check

graphon whoami

Next steps

Was this page helpful?