open-agent-sdk

Build AI agents with built-in tools, hooks, MCP, and multi-turn sessions.

Install

npm install open-agent-sdk

Quick Start

import { query } from "open-agent-sdk";

for await (const message of query("Find and fix the bug in auth.py", {
  allowedTools: ["Read", "Edit", "Bash"],
  permissionMode: "acceptEdits",
})) {
  if (message.type === "result") console.log(message.result);
}

Features

• Built-in tools: Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch
• V2 Session API: Multi-turn persistent conversations
• 27 Hook events: PreToolUse, PostToolUse, SessionStart, etc.
• MCP: Connect to databases, browsers, APIs via Model Context Protocol
• Subagents: Spawn specialized agents for focused subtasks
• 6 Permission modes: default, acceptEdits, auto, dontAsk, plan, bypassPermissions
• Session management: List, resume, fork, rename, tag sessions

License

MIT