Robota - AI Agent Framework

A TypeScript framework for building AI agents with multi-provider support, tool calling, and extensible plugin architecture.

Quick Start

CLI — AI Coding Assistant

npm install -g @robota-sdk/agent-cli
robota

macOS users: Korean/CJK IME input may crash macOS Terminal.app. Use iTerm2 instead. This is a known Ink + Terminal.app issue shared with Claude Code.

SDK — Programmatic Usage

import { query } from '@robota-sdk/agent-sdk';

const response = await query('List all TypeScript files in src/');

Core — Build Custom Agents

import { Robota } from '@robota-sdk/agent-core';
import { AnthropicProvider } from '@robota-sdk/agent-provider-anthropic';

const agent = new Robota({
  name: 'MyAgent',
  aiProviders: [new AnthropicProvider({ apiKey: process.env.ANTHROPIC_API_KEY })],
  defaultModel: {
    provider: 'anthropic',
    model: 'claude-sonnet-4-6',
    systemMessage: 'You are a helpful assistant.',
  },
});

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

Architecture

agent-cli         ← Interactive terminal AI coding assistant
  ↓
agent-sdk         ← Assembly layer: config, context, session factory, query()
  ↓
agent-sessions    ← Session lifecycle: permissions, hooks, compaction
agent-tools       ← Tool infrastructure + 8 built-in tools
agent-providers   ← AI provider implementations
  ↓
agent-core        ← Foundation: Robota engine, abstractions, plugins

Packages

| Package | Description | |---------|-------------| | @robota-sdk/agent-core | Core agent runtime, abstractions, and plugin system | | @robota-sdk/agent-tools | Tool registry, FunctionTool, and 8 built-in tools | | @robota-sdk/agent-sessions | Session with permissions, hooks, and compaction | | @robota-sdk/agent-sdk | Assembly layer with config/context loading and query() | | @robota-sdk/agent-provider-anthropic | Anthropic Claude provider | | @robota-sdk/agent-cli | Interactive terminal AI coding assistant |

Documentation

Full documentation at robota.io

• Getting Started
• Building Agents
• SDK Usage
• CLI Reference
• Examples

Development

pnpm install
pnpm build
pnpm test

Node.js 18+ required. See Development Guide for details.

License

MIT