Orkhub CLI

Scaffold, run, test, and publish AI agents from your terminal.

The CLI is a thin client over the Orkhub API: your agent code lives locally (edit it, commit it), and runs on Orkhub's cloud sandboxes — the live trace streams back to your terminal. No local Python or model keys required to run.

Install

npm install -g orkhub
orkhub version

Requires Node.js 18+.

Quickstart

# 1. Create an API key at https://orkhub.com/developers/keys
orkhub login                      # paste the ork_… key

# 2. Scaffold, push, run
orkhub init my-agent
cd my-agent
orkhub push                       # upload to Orkhub
orkhub run -m "hello"             # run on Orkhub, trace streams here

# 3. Ship
orkhub test                       # run your evals
orkhub publish                    # validate → test → snapshot → marketplace

Commands

| Command | Description | | --- | --- | | orkhub login | Save & verify your API key (--key, --url for CI) | | orkhub whoami / logout | Show / clear the logged-in account | | orkhub init <name> | Scaffold a runnable agent (with the SDK bundled) into ./<name> | | orkhub push | Create/update the agent on Orkhub and upload its files | | orkhub run -m "<msg>" | Run on Orkhub; streams the trace and prompts on pauses | | orkhub dev | Interactive run loop | | orkhub generate "<desc>" | Build an agent from a description (plan → build → test) | | orkhub test | Run the agent's evals.yaml | | orkhub publish | Publish a new version to the marketplace |

Authentication

Uses an API key stored in ~/.orkhub/config.json. For CI, set ORKHUB_API_KEY and ORKHUB_API_URL in the environment (they override the saved config).

export ORKHUB_API_KEY=ork_…
export ORKHUB_API_URL=https://orkhub.com
orkhub push && orkhub publish

Project layout

orkhub init creates:

my-agent/
  orkhub.yaml        # manifest: name, prompt, model, tools, limits, pricing
  agent.py           # @tool functions + Agent.from_manifest()
  ui.json            # the agent's input/output page
  evals.yaml         # test cases
  requirements.txt   # Python deps
  README.md
  orkhub/            # bundled Python SDK

License

MIT