Agent Plane

A powerful, extensible agent framework built on LangChain 1.0+ with TypeScript. Create AI agents that can use tools, manage sessions, and handle complex multi-step tasks.

Quick Start

Installation

npm install agent-plane

Basic Usage

import { createAgentPlane } from 'agent-plane';

// Create an agent
const agent = await createAgentPlane({
  modelName: 'gpt-4o-mini',
  verbose: true,
});

// Initialize
await agent.initialize();

// Run
const response = await agent.run('What is 2+2?');
console.log(response);

With Environment Variables

Create a .env file:

OPENAI_API_KEY=your_key_here
# or
ANTHROPIC_API_KEY=your_key_here

import { createAgentPlane } from 'agent-plane';
import { createProviderFromEnv } from 'agent-plane/llm';

const provider = createProviderFromEnv();
const agent = await createAgentPlane({
  provider,
  verbose: true,
});

await agent.initialize();
const response = await agent.run('Hello!');

Quick Commands

# Install dependencies
npm install

# Build the project
npm run build:all

# Run tests
npm test

# Start development server
npm run dev

# Run macOS app
npm run macos:dev

# Create a new extension
npm run create-extension

Features

• ✅ Deep Agent Architecture - Full compatibility with langchain-ai/deepagentsjs
• ✅ Planning Tools - Automatic task breakdown with todo lists
• ✅ Filesystem Tools - File operations, code editing, execution
• ✅ Sub-Agents - Custom sub-agents and task delegation
• ✅ Session Management - Persistent conversation history
• ✅ Execution Tracking - Real-time execution tree visualization
• ✅ Streaming - Multiple streaming modes for real-time updates
• ✅ Extension System - Create and share extensions
• ✅ macOS App - Native desktop application

Documentation

• DEVELOPMENT.md - Complete development guide with architecture details, API reference, and examples

License

MIT