Library

Use peek programmatically from TypeScript.

peek ships as a TypeScript library (the agent-peek package) in addition to the CLI and MCP server. Import createEngine to list and peek at sessions from your own code:

import { createEngine } from "agent-peek";

const engine = await createEngine();
const sessions = await engine.list();

const result = await engine.peek("researcher", { mode: "brief" });
const firstPage = await engine.peek("researcher", { mode: "raw", from: "start", limit: 50 });

console.log(result.snapshot);
console.log(result.nextCursor);

Entry points

The package exposes three import paths: