·
139 commits
to main
since this release
Release v0.1.0-alpha.0
🎉 Open Agent SDK First Alpha Release
The first public alpha release of Open Agent SDK, providing core features compatible with Claude Agent SDK.
📦 Installation
npm install open-agent-sdk@alphaOther package managers:
yarn add open-agent-sdk@alpha
pnpm add open-agent-sdk@alpha
bun add open-agent-sdk@alpha✨ Key Features
17 Built-in Tools
- File Operations: Read, Write, Edit
- Shell Execution: Bash, BashOutput, KillBash
- Code Search: Glob, Grep
- Web Tools: WebSearch, WebFetch
- Task Management: Task, TaskList, TaskCreate, TaskGet, TaskUpdate
- Interaction: AskUserQuestion
Multi-Provider Support
- ✅ OpenAI
- ✅ Google Gemini
- ✅ Anthropic
Session Management
createSession()- Create new sessionresumeSession()- Resume existing sessionforkSession()- Fork session for branching- Supports
InMemoryStorageandFileStorage
Advanced Features
- Hooks System: 12 events defined, 9 auto-triggered
- Permission System: 4 modes (default/acceptEdits/bypassPermissions/plan)
- Subagent: Task tool for delegation
- MCP Support: stdio/sse/http/sdk configurations
- Cancellation: AbortController support
🚀 Quick Start
import { prompt } from 'open-agent-sdk';
const result = await prompt("What files are in the current directory?", {
model: 'your-model',
apiKey: process.env.OPENAI_API_KEY,
});
console.log(result.result);Session Mode
import { createSession, FileStorage } from 'open-agent-sdk';
const storage = new FileStorage();
const session = await createSession({
model: 'your-model',
apiKey: process.env.OPENAI_API_KEY,
storage,
});
await session.send("Hello!");
for await (const msg of session.stream()) {
console.log(msg);
}🔄 Comparison with Claude Agent SDK
Implemented (Compatible)
- ✅ ReAct Loop
- ✅ Read/Write/Edit/Bash/Glob/Grep
- ✅ WebSearch/WebFetch
- ✅ Session Management (create/resume/fork)
- ✅ Permission System (4 modes)
- ✅ Hooks System
- ✅ Subagent (Task)
- ✅ MCP Configuration Support
Not Yet Implemented
- ❌ Browser Automation
- ❌ Structured Output (outputFormat)
- ❌ File Checkpoint
- ❌ Skill System
Feature Completeness: ~70-80%
🗺️ Roadmap
| Version | Features | Status |
|---|---|---|
| v0.1.0-alpha | Core features release | ✅ |
| v0.1.0-beta | Structured outputs, file checkpoint | 🚧 |
| v0.1.0 | Stable release | 📋 |
| v0.2.0 | Browser automation, skill system | 📋 |
🤝 Contributing
Issues and PRs welcome!
- GitHub: https://github.com/Octane0411/open-agent-sdk
- Issues: https://github.com/Octane0411/open-agent-sdk/issues
📄 License
MIT License © 2026 Octane0411