CLI Getting Started

The server-side SDK lives in @uclaw/sdk. Command line tooling lives in @uclaw/cli.

Install or Run the CLI

npm install -g @uclaw/cli
# or run with npx
npx @uclaw/cli --help

Authenticate

Create an API key in the developer dashboard, then authenticate the CLI:

npx @uclaw/cli login

You can also set the key directly for scripts:

export UCLAW_API_KEY="uc_live_..."

Server-Side SDK Script

For programmable agent workflows, use @uclaw/sdk:

import { AppClient } from "@uclaw/sdk";

const app = new AppClient({
  apiKey: process.env.UCLAW_API_KEY,
});

const agent = await app.agents.create({
  title: "CLI assistant",
  config: {
    model: "anthropic/claude-sonnet-4",
    instructions: "You are a helpful software engineering assistant.",
  },
});

const run = await agent.run("Create a hello world project in Node.js");
await run.wait({ until: "running", timeoutMs: 60_000 });

for await (const event of run.stream()) {
  if (event.type === "text-delta") {
    process.stdout.write(event.delta);
  }
}

Next Steps

To connect your agents with a frontend framework, proceed to the React Getting Started guide.