Getting Started

The fastest way to install and get started is to install the CLI:

curl -fsSL https://agentuity.sh | sh

 

Visit https://agentuity.com/ to learn more about Agentuity and create a free account or sign up in the CLI after installation.

Agent Skills

This repository includes Agent Skills that teach AI coding agents how to work with the Agentuity SDK. Install them with:

npx skills add agentuity/sdk

Available skills:

Skill	Description
agentuity-agents	Building agents with createAgent, schemas, context APIs, state management
agentuity-routing	API routes, middleware, WebSocket/SSE/WebRTC handlers
agentuity-cli	Project scaffolding, dev server, deployment, cloud services
agentuity-workbench	Interactive dev UI for testing agents

See skills/README.md for details.

Documentation

Visit https://agentuity.dev to view the full documentation.

Community

The Agentuity community can be found on GitHub Discussions where you can discuss ideas, give feedback and share your projects with others.

To chat with other community members you can join the Agentuity Discord server.

Development

Structure

The structure of this mono repository:

• packages/auth - Agentuity unified Authentication package
• packages/claude-code - Claude Code plugin with multi-agent coding team
• packages/cli - the Agentuity command line tool
• packages/core - Shared utilities used by most packages
• packages/db - Database service client for querying and managing databases
• packages/drizzle - Drizzle ORM integration with resilient PostgreSQL connections
• packages/email - Email service client for managing email addresses and sending emails
• packages/evals - Reusable Evaluation Presets
• packages/frontend - Reusable code for web frontends including WebRTC peer connections
• packages/keyvalue - Key-value storage service client
• packages/opencode - Opencode agent plugins for Agentuity
• packages/postgres - Resilient PostgreSQL client with automatic reconnection
• packages/queue - Queue service client for publishing messages to queues
• packages/react - React package for the Browser including WebRTC hooks
• packages/runtime - Server-side package for the Agent runtime with WebRTC signaling
• packages/sandbox - Sandbox service client for managing code execution environments
• packages/schedule - Schedule service client for managing cron-based scheduled tasks
• packages/schema - Schema validation library similar to zod and arktype
• packages/server - Runtime-agnostic server-side SDK (Node.js & Bun)
• packages/task - Task management service client for tasks, comments, and attachments
• packages/test-utils - Internal test utilities that can be used by packages
• packages/vector - Vector search service client for semantic search
• packages/vscode - VS Code extension for Agentuity
• packages/webhook - Webhook service client for managing webhooks and destinations
• packages/workbench - Workbench UI component

Each package is its own published npm package but all packages are versioned and published together.

Setup

bun install

Build

bun run build

Testing

Run the following to do a cycle of lint, typecheck, format and test:

bun all

For development workflow verification, ensure all commands run successfully before creating a PR.

Linking to External Projects

To use the SDK in development mode with an existing project outside this repo:

./scripts/link-local.sh /path/to/your/project

This script builds all packages, creates tarballs, and installs them in your target project. After linking, run bun run build or bun run dev in your project to rebuild with the local SDK changes.

LICENSE

See the LICENSE for more information about the license to this project. The code is licensed under the Apache-2 License.