AGO Developer Kit

Examples, Claude Code skills, and documentation to help you integrate AGO into your application.

What's inside

ago-developer-kit/
├── skills/ # Claude Code skills for AI-assisted AGO integration
│ ├── ago-setup/ # /ago-setup — Install & configure the SDK
│ ├── ago-function/ # /ago-function — Create client-side functions
│ ├── ago-react/ # /ago-react — Build custom React chat UI
│ └── ago-widget/ # /ago-widget — Embed the chat widget
├── examples/
│ ├── react-chat/ # Custom chat UI with React hooks
│ ├── nextjs/ # Next.js App Router integration
│ ├── vanilla-js/ # No framework, plain JavaScript
│ ├── react-client-functions/ # Client-side functions the agent can call
│ └── widget-embed/ # Widget embed with script tag
└── docs/ # Integration guides

Quick start

Install Claude Code skills (recommended)

The fastest way to get started — let Claude Code set up AGO for you:

git clone https://github.com/useago/ago-developer-kit.git ~/.claude/skills/ago-developer-kit
cd~/.claude/skills/ago-developer-kit && ./setup

Then open Claude Code in your project and type:

/ago-setup

Claude will install @useago/sdk, configure the client, and set up environment variables.

Available skills

Skill	Description
/ago-setup	Install & configure @useago/sdk in any JS/TS project
/ago-function	Create a client-side function that AGO agents can call from the browser
/ago-react	Build a custom chat interface with React hooks (useChat, useMessages)
/ago-widget	Embed the AGO chat widget with a single script tag

Team mode

Share the skills with your team by adding them to your project:

cd<your-project>~/.claude/skills/ago-developer-kit/setup --local
git add .claude/skills && git commit -m "Add AGO developer skills"

Examples

Each example is a standalone project you can run locally. Set your AGO instance URL in the .env file.

React chat (examples/react-chat/)

Custom chat interface using useChat hook:

cd examples/react-chat
npm install
cp .env.example .env # Set your AGO base URL
npm run dev

Next.js (examples/nextjs/)

AGO integration in a Next.js App Router app:

cd examples/nextjs
npm install
cp .env.example .env # Set your AGO base URL
npm run dev

Vanilla JS (examples/vanilla-js/)

No framework — plain HTML + JavaScript with the SDK:

cd examples/vanilla-js
# Edit index.html to set your AGO base URL
npx serve .

Client functions (examples/react-client-functions/)

Define functions that AGO agents can call in the browser:

cd examples/react-client-functions
npm install
cp .env.example .env # Set your AGO base URL
npm run dev

Widget embed (examples/widget-embed/)

Embed the chat widget with a script tag — no build step:

cd examples/widget-embed
# Edit index.html to set your AGO base URL
open index.html

Prerequisites

• An AGO instance URL (e.g., https://YOUR-DOMAIN.useago.com)
• Node.js 16+
• For Claude Code skills: Claude Code installed

Documentation

• Getting Started
• React Integration
• Client Functions
• Embed Widget

License

MIT