openpond-code

API-key CLI + local TUI client for OpenPond.

API key CLI (openpond/op)

Install:

npm i -g openpond-code
# or
npx --package openpond-code openpond tool list handle/repo
# or (curl installer)
curl -fsSL https://openpond.ai/install.sh | bash

Login (stores key in ~/.openpond/config.json):

openpond login
# or (non-interactive)
openpond login --api-key opk_...

Commands:

openpond tool list <handle>/<repo>
openpond tool run <handle>/<repo> <tool> --body '{"foo":"bar"}'
openpond deploy watch <handle>/<repo> --branch main
openpond template status <handle>/<repo>
openpond template branches <handle>/<repo>
openpond template update <handle>/<repo> --env production
openpond repo create --name my-repo --path .
openpond repo push --path . --branch main
openpond apps list [--handle <handle>] [--refresh]
openpond apps tools
openpond apps deploy <handle>/<repo> --env production --watch
openpond apps env get <handle>/<repo>
openpond apps env set <handle>/<repo> --env '{"OPENTOOL_PUBLIC_HL_SIGNAL_BOT_CONFIG":"..."}'
openpond apps performance [--app-id <id>]
openpond apps agent create --prompt "Build a daily digest agent"
openpond apps tools execute <appId> <deploymentId> <tool> --body '{"foo":"bar"}'
openpond apps positions tx --method GET --params '{"status":"open"}'
openpond opentool init --dir .

Command reference:

• openpond login: prompt for API key and save to ~/.openpond/config.json.
• openpond login --api-key <key>: save the API key without prompting.
• openpond tool list <handle>/<repo>: list tools for the latest deployment.
• openpond tool run <handle>/<repo> <tool> [--body <json>] [--method <METHOD>]: run a tool on the latest deployment.
• openpond deploy watch <handle>/<repo> [--branch <branch>]: stream deployment logs for the latest deployment.
• openpond template status <handle>/<repo>: check whether a template update is available.
• openpond template branches <handle>/<repo>: list available template branches.
• openpond template update <handle>/<repo> [--env preview|production]: deploy the latest template commit.
• openpond repo create --name <name> [--path <dir>] [--empty|--opentool] [--deploy-on-push]: create an internal repo and attach the git remote.
• openpond repo push [--path <dir>] [--branch <branch>]: push the current git branch using a tokenized remote (non-interactive, restores origin after push).
• openpond apps list [--handle <handle>] [--refresh]: list apps for your account, optionally filtered by handle.
• openpond apps tools: list tools for your account (public API).
• openpond apps deploy <handle>/<repo> [--env preview|production] [--watch]: trigger a deployment for an app.
• openpond apps env get <handle>/<repo>: get OPENTOOL_PUBLIC_* env vars for an app.
• openpond apps env set <handle>/<repo> --env <json>: set OPENTOOL_PUBLIC_* env vars for an app.
• openpond apps performance [--app-id <id>]: fetch performance summary, optionally scoped to an app.
• openpond apps agent create --prompt <text> [--template-id <id>]: create an agent from a prompt (streams deploy logs by default).
• openpond apps tools execute <appId> <deploymentId> <tool> [--body <json>] [--method <METHOD>] [--headers <json>]: execute a tool for a specific deployment.
• openpond apps positions tx [--method <GET|POST>] [--body <json>] [--params <json>]: read or submit positions.
• openpond opentool <init|validate|build> [args]: run OpenTool CLI commands via npx opentool.

TypeScript package

Programmatic API that mirrors the CLI command surface:

import { createClient } from "openpond-code";

const client = createClient({ apiKey: process.env.OPENPOND_API_KEY! });

const { tools } = await client.tool.list("handle/repo");
const result = await client.tool.run("handle/repo", "myTool", {
  body: { foo: "bar" },
});

const apps = await client.apps.list();
const accountTools = await client.apps.tools();
const performance = await client.apps.performance({ appId: "app_123" });
const repo = await client.repo.create({ name: "my-repo", repoInit: "empty" });

await client.apps.agentCreate(
  { prompt: "Build a daily digest agent" },
  {
    onItems: (items) => {
      for (const item of items) {
        console.log(item);
      }
    },
  }
);

You can override hosts with baseUrl, apiUrl, and toolUrl in createClient, or via OPENPOND_BASE_URL, OPENPOND_API_URL, and OPENPOND_TOOL_URL.

Examples live in examples.

Local TUI

Minimal terminal client for OpenPond chat + history. This is a standalone folder intended to be extracted into its own repo later.

Run

bun install
bun run dev

Cache:

• ~/.openpond/cache.json caches app/tool lists for 1 hour and refreshes automatically on next use.