Session

A Session manages a conversation with an AI model about a code repository.

Sessions provide:

Multi-turn conversations with message history
Tool execution (file reading, code search, etc.)
Progress callbacks for streaming UI updates
Automatic cleanup of git worktrees on close

Example

const session = await connect(repoUrl);
const result = await session.ask("What does this repo do?");
console.log(result.response);
session.close();

Properties

id

readonly id: string

Defined in: src/session.ts:268

Unique identifier for this session

repo

readonly repo: Repo

Defined in: src/session.ts:270

The repository this session is connected to

Methods

ask()

ask(question, options?): Promise<AskResult>

Defined in: src/session.ts:338

Ask a question about the repository.

The model will use available tools to explore the codebase and formulate an answer. Concurrent calls are serialized (queued) to maintain conversation coherence.

Parameters

question

string

The question to ask

options?

AskOptions

Optional settings including progress callback

Returns

Promise<AskResult>

Result containing the response, tool calls made, and usage statistics

Throws

Error if the session has been closed

askStream()

askStream(prompt, options?): AskStream

Defined in: src/session.ts:364

Ask a question and get a streaming response (new API).

Returns an AskStream synchronously. The stream starts producing events when consumed (iterated or .result() awaited). Concurrent calls are serialized — the second stream won’t produce events until the first completes.