Quickstart

pnpm add @klein-kit/core

import { createAgent, detectProviders } from "@klein-kit/core";

// What's installed and logged in on this machine?
console.log(await detectProviders());

const session = await createAgent({
  provider: "codex",
  permissionMode: "ask",
  onPermissionRequest: async (req) => {
    // Your UI decides. req carries the native payload on req.raw.
    return { behavior: req.kind === "shell" ? "deny" : "allow" };
  },
});

const turn = session.prompt("Fix the failing test in src/auth.ts");
for await (const event of turn) {
  switch (event.type) {
    case "message.delta":   process.stdout.write(event.text); break;
    case "plan.updated":    renderPlan(event.plan); break;
    case "tool.started":    console.log(`→ ${event.tool.name}`); break;
    case "usage.updated":   showContextMeter(event.usage); break;
  }
}
const result = await turn; // { text, usage, filesChanged, stopReason }

// Resume later, even after your app restarts:
const id = session.nativeSessionId;