Exit codes are in Install and sign in.
| Command | What it does |
|---|---|
konnecthub init | Scaffold a project here. Links no flows |
konnecthub link [flow…] | Adopt flows that already exist in the workspace |
konnecthub new <name> | Create a flow, remotely and locally, from a template. --graph to build it as a graph, --library for a library, --node for a custom node type, --dir to name its directory |
| Command | What it does |
|---|---|
konnecthub pull [flow…] | Bring the draft into the working tree |
konnecthub push [flow…] | Send the working tree to the draft. --resolved after fixing conflicts |
konnecthub reset [flow…] | Take the remote copy, discarding local edits |
konnecthub checkout <n> | Start the draft from published version n |
| Command | What it does |
|---|---|
konnecthub test [flow…] | Run this project's fixtures as draft runs. --case <name> for one |
konnecthub deploy [flow…] | Push, publish, wait for READY, activate |
konnecthub rollback <n> | Make an earlier published version active again |
| Command | What it does |
|---|---|
konnecthub runs | Recent executions of this project's flows |
konnecthub inspect <run> | Why a run did what it did — summary first |
konnecthub logs <run> | A run's log lines. --tail, --follow |
| Command | What it does |
|---|---|
konnecthub check [flow…] | Validate locally — no network |
konnecthub types | Cache the platform's SDK declarations |
konnecthub libs | Mirror published workspace libraries so lib: resolves |
konnecthub skills | Refresh the generated agent instructions in .claude/skills/ |
| Command | What it does |
|---|---|
konnecthub routes [pattern] | List API routes. --show <method> <path> for one route's shape |
konnecthub api <method> <path> | Call any route — the escape hatch |
| Command | What it does |
|---|---|
konnecthub login | Authenticate through the browser and store a token for this origin and workspace |
konnecthub whoami | The active token, its identity, workspace and scopes |
konnecthub logout | Forget the stored credentials for this project’s workspace (--all, --global widen it) |
konnecthub upgrade | Install the CLI version this API serves |
konnecthub completions [shell] | Print the shell completion script |
Accepted by every command.
| Flag | What it does |
|---|---|
--json | Machine-readable output: one JSON document on stdout, NDJSON for streams |
--origin <url> | Which KonnectHub to talk to. Defaults to https://app.konnecthub.io, or to the origin in konnecthub.json when you are inside a project |
--cwd <dir> | Run as if started in this directory |
--no-color | Disable ANSI colour |
--help, -h | Usage for that command |
| Variable | Used for |
|---|---|
KONNECTHUB_TOKEN | Authenticate without a browser. The CI path |
KONNECTHUB_ORIGIN | Which KonnectHub to talk to, for a machine that is not in a project. --origin wins over it |
KONNECTHUB_FLOW | Point check's typecheck at a flow binary elsewhere |
KONNECTHUB_HOME | Move the CLI's own directory — the binary, the global credentials and the shared caches |