@juny-klave/cli

Terminal CLI for KLAVE — negotiate anything from the command line. Private, autonomous, cryptographically verifiable.

Install

npm install -g @juny-klave/cli

Commands

klave demo

Full negotiation simulation. No API key. No setup. Runs in ~25 seconds.

klave demo

With custom parameters:

klave demo \
  --subject "Senior backend engineer, 6-month contract" \
  --asking 185 \
  --max 150 \
  --counterparty "Acme Corp" \
  --unit "per hour"

Watch the concession algorithm converge round by round. Ceiling never shown. Seller floor never shown. ZK proof at the end.

klave negotiate

Run a real negotiation via the KLAVE API.

klave negotiate \
  --subject "200 FEU containers Shanghai to Rotterdam" \
  --asking 2806 \
  --max 2650 \
  --counterparty "Pacific Line Carriers" \
  --api-key YOUR_KEY

Options:

| Flag | Required | Description | |---|---|---| | --subject | ✓ | What is being negotiated | | --asking | ✓ | Counterparty's asking price | | --max | ✓ | Your ceiling price (private — never disclosed) | | --counterparty | — | Name of the other party | | --currency | — | ISO 4217 code (default: USD) | | --unit | — | Unit of measure (FEU, hour, sqft…) | | --api-key | ✓ | KLAVE API key (or set KLAVE_API_KEY) |

klave scope create

Issue an AgentScope authorization token — bounds the agent's max transaction and weekly budget.

klave scope create \
  --max 5000 \
  --weekly 20000 \
  --api-key YOUR_KEY

Options:

| Flag | Default | Description | |---|---|---| | --max | — | Max per-deal amount in dollars | | --weekly | 50000 | Max weekly budget in dollars | | --agent-id | cli-agent | Agent identifier | | --buyer-id | cli-buyer | Buyer identifier | | --days | 7 | Token validity in days |

klave result <session-id>

Inspect a completed session — settlement price, round history, and ZK proof status.

klave result abc123 --api-key YOUR_KEY

What KLAVE does

Two autonomous agents negotiate a price. Neither reveals their limit. The deal that works for both parties clears — with a zero-knowledge proof confirming it was conducted fairly.

• Buyer ceiling — private, never disclosed to the counterparty or to KLAVE
• Seller floor — encrypted server-side, never in any API response
• Settlement — midpoint of converging offers when both cross
• ZK proof — cryptographic confirmation that no private limits leaked

API key

Get one at klavecommerce.com.

Set as an environment variable to avoid passing it on every command:

export KLAVE_API_KEY=your_key_here

MCP server

If you're using Claude Desktop or Claude Code, use the MCP server instead:

claude mcp add klave \
  --transport sse \
  "https://klave1-production.up.railway.app/mcp/sse" \
  --header "x-api-key:YOUR_API_KEY"

Package: @juny-klave/mcp

License

MIT