kura-agent-cli

Command-line interface for Kura. Two surfaces:

1. kura agent ... — submit AI-built sites to Kura's agent-import endpoints (customer-facing).
2. kura pull / push / status / abort / extend / serve — local Claude Code editing for Kura-managed sites (admin-only).

Install

npm install -g kura-agent-cli

Auth

Mint an API key:

• Customers: www.kurawebsites.com/account/api-keys (scope: agent-import)
• Admins: www.kurawebsites.com/admin/settings/api-keys (scope: admin-full)

Then either:

export KURA_API_KEY=kura_<your-48-hex-key>

Or create ~/.kurarc:

{ "api_key": "kura_<your-48-hex-key>" }

Agent-import usage (customer-facing)

From the root of your agent-built site directory (the one containing kura.config.json):

kura agent validate .           # dry-run — no side effects
kura agent submit .             # create the project on Kura
kura agent status <projectId>   # check build progress

The CLI walks the directory, skips node_modules / dist / .env*, classifies each file as utf-8 text or base64 binary by extension, and POSTs the bundle to the orchestrator's /api/agent/projects endpoint.

See the agent integration guide for the full kura.config.json schema and per-framework rules.

Admin usage

For Kura admins managing existing customer projects:

kura pull <project-id|slug>     # fetch pages locally + claim lock
kura status                     # show local changes
kura push [--yes]               # save + publish + release lock
kura abort                      # release lock without writing
kura extend                     # extend lock by 2h
kura serve [--port=4001]        # localhost preview

Requires an admin-full scope key.

Configuration

KURA_API_KEY      — your bearer token (required, kura_<48 hex>)
KURA_BASE_URL     — orchestrator URL (defaults to prod)

Source

This package lives in github.com/benbybee/kura-orchestrator/tree/main/cli. PRs welcome.