Integration Patterns

Multiple Agents in One Repo

Use multiple agentIds to isolate different SDK Agents in the same project directory

If you create several local SDK Agents inside the same project directory, the most important rule is:

For example:

new Agent({ id: "planner", path: repoPath, tools: {} });
new Agent({ id: "reviewer", path: repoPath, tools: {} });

That keeps their sessions in different directories instead of mixing them together.

This is especially useful when one repository needs several agents with different roles.

Embed in a Node App

Recommended pattern for creating and using a local Agent directly inside a Node.js application

Expose an Agent over HTTP

Turn a local Agent into an HTTP service for other processes or clients