diff --git a/src/pages/docs/ai-transport/getting-started/anthropic.mdx b/src/pages/docs/ai-transport/getting-started/anthropic.mdx index f54b9583f7..8f0e6c2a66 100644 --- a/src/pages/docs/ai-transport/getting-started/anthropic.mdx +++ b/src/pages/docs/ai-transport/getting-started/anthropic.mdx @@ -11,6 +11,10 @@ This guide will get you started with Ably AI Transport using Anthropic's Message You'll learn how to authenticate users with verified identities, stream tokens from an agent to clients in realtime, and implement human-in-the-loop approval for tool calls. The agent uses Anthropic's Claude model with a `send_email` tool that requires user approval before execution. + + ## Prerequisites 1. [Sign up](https://ably.com/signup) for an Ably account. diff --git a/src/pages/docs/ai-transport/getting-started/langgraph.mdx b/src/pages/docs/ai-transport/getting-started/langgraph.mdx index b15d278955..66c05c7fad 100644 --- a/src/pages/docs/ai-transport/getting-started/langgraph.mdx +++ b/src/pages/docs/ai-transport/getting-started/langgraph.mdx @@ -8,6 +8,10 @@ This guide will get you started with Ably AI Transport using LangGraph. You'll learn how to authenticate users with verified identities, stream tokens from an agent to clients in realtime, and implement human-in-the-loop approval for tool calls. The agent uses LangGraph with a `send_email` tool that requires user approval before execution. + + ## Prerequisites 1. [Sign up](https://ably.com/signup) for an Ably account. diff --git a/src/pages/docs/ai-transport/getting-started/openai.mdx b/src/pages/docs/ai-transport/getting-started/openai.mdx index b216a10797..c437b2e554 100644 --- a/src/pages/docs/ai-transport/getting-started/openai.mdx +++ b/src/pages/docs/ai-transport/getting-started/openai.mdx @@ -8,6 +8,10 @@ This guide will get you started with Ably AI Transport using OpenAI's Responses You'll learn how to authenticate users with verified identities, stream tokens from an agent to clients in realtime, and implement human-in-the-loop approval for tool calls. The agent uses OpenAI's GPT model with a `send_email` tool that requires user approval before execution. + + ## Prerequisites 1. [Sign up](https://ably.com/signup) for an Ably account. diff --git a/src/pages/docs/ai-transport/getting-started/vercel-ai-sdk.mdx b/src/pages/docs/ai-transport/getting-started/vercel-ai-sdk.mdx index 7e41d920ce..a4770f3a66 100644 --- a/src/pages/docs/ai-transport/getting-started/vercel-ai-sdk.mdx +++ b/src/pages/docs/ai-transport/getting-started/vercel-ai-sdk.mdx @@ -8,6 +8,10 @@ This guide will get you started with Ably AI Transport using the Vercel AI SDK. You'll learn how to authenticate users with verified identities, stream tokens from an agent to clients in realtime, and implement human-in-the-loop approval for tool calls. The agent uses the Vercel AI SDK with a `send_email` tool that requires user approval before execution. + + ## Prerequisites 1. [Sign up](https://ably.com/signup) for an Ably account. diff --git a/src/pages/docs/chat/getting-started/android.mdx b/src/pages/docs/chat/getting-started/android.mdx index dd354c2a65..a5632c5b72 100644 --- a/src/pages/docs/chat/getting-started/android.mdx +++ b/src/pages/docs/chat/getting-started/android.mdx @@ -10,6 +10,10 @@ You'll learn how to create chat rooms, send and edit messages, and implement rea ![Screenshot of the completed Android Chat application showing a web interface with connection status, a message input field, realtime message display, and a presence indicator showing online users. The interface demonstrates the key features you'll build including publishing messages, subscribing to receive messages in realtime, and tracking which clients are currently present in the channel.](../../../../images/content/screenshots/getting-started/chat-kotlin-getting-started-guide.png) + + ## Prerequisites ### Ably diff --git a/src/pages/docs/chat/getting-started/index.mdx b/src/pages/docs/chat/getting-started/index.mdx index db97eb8d84..507f916edb 100644 --- a/src/pages/docs/chat/getting-started/index.mdx +++ b/src/pages/docs/chat/getting-started/index.mdx @@ -12,6 +12,10 @@ You'll learn the essentials of building realtime chat applications, including ho These are your first steps towards building a Chat application that can effortlessly scale to serve millions of users. + + {[ { diff --git a/src/pages/docs/chat/getting-started/javascript.mdx b/src/pages/docs/chat/getting-started/javascript.mdx index 1795696bee..454e154838 100644 --- a/src/pages/docs/chat/getting-started/javascript.mdx +++ b/src/pages/docs/chat/getting-started/javascript.mdx @@ -8,6 +8,10 @@ This guide will get you started with Ably Chat using TypeScript. You'll learn how to create chat rooms, send and edit messages, and implement realtime features like typing indicators and presence. You'll also cover message history, reactions, and proper connection management. + + ## Prerequisites 1. Sign up for an Ably account. diff --git a/src/pages/docs/chat/getting-started/jvm.mdx b/src/pages/docs/chat/getting-started/jvm.mdx index abb15b89e0..475c54bc5e 100644 --- a/src/pages/docs/chat/getting-started/jvm.mdx +++ b/src/pages/docs/chat/getting-started/jvm.mdx @@ -8,6 +8,10 @@ This guide will help you get started with Ably Chat in a new JVM application usi You'll learn how to create chat rooms, send and edit messages, and implement realtime features like typing indicators and presence. You'll also cover message history, reactions, and proper connection management. + + ## Prerequisites ### Ably diff --git a/src/pages/docs/chat/getting-started/react-native.mdx b/src/pages/docs/chat/getting-started/react-native.mdx index e06c4c6a38..b417816ba5 100644 --- a/src/pages/docs/chat/getting-started/react-native.mdx +++ b/src/pages/docs/chat/getting-started/react-native.mdx @@ -10,6 +10,10 @@ You'll learn how to create chat rooms, send and edit messages, and implement rea ![Screenshot of the completed React Native Chat application showing a web interface with connection status, a message input field, realtime message display, and a presence indicator showing online users. The interface demonstrates the key features you'll build including publishing messages, subscribing to receive messages in realtime, and tracking which clients are currently present in the channel.](../../../../images/content/screenshots/getting-started/chat-react-native-getting-started-guide.png) + + ## Prerequisites ### Ably diff --git a/src/pages/docs/chat/getting-started/react-ui-kit.mdx b/src/pages/docs/chat/getting-started/react-ui-kit.mdx index cea08e6ee1..5b02391728 100644 --- a/src/pages/docs/chat/getting-started/react-ui-kit.mdx +++ b/src/pages/docs/chat/getting-started/react-ui-kit.mdx @@ -10,6 +10,10 @@ This guide shows you how to add the Ably Chat React UI Kit to a brand-new React You'll create Ably clients, install the UI component package, and build a complete chat interface. You'll also cover customizing the look and feel with your own styles, settings, and avatars. + + ## Prerequisites 1. Sign up for an Ably account. diff --git a/src/pages/docs/chat/getting-started/react.mdx b/src/pages/docs/chat/getting-started/react.mdx index 041442bd72..348634a977 100644 --- a/src/pages/docs/chat/getting-started/react.mdx +++ b/src/pages/docs/chat/getting-started/react.mdx @@ -10,6 +10,10 @@ You'll learn how to create chat rooms, send and edit messages, and implement rea ![Screenshot of the completed React Chat application showing a web interface with connection status, a message input field, realtime message display, and a presence indicator showing online users. The interface demonstrates the key features you'll build including publishing messages, subscribing to receive messages in realtime, and tracking which clients are currently present in the channel.](../../../../images/content/screenshots/getting-started/chat-react-getting-started-guide.png) + + ## Prerequisites ### Ably diff --git a/src/pages/docs/chat/getting-started/swift-async-sequence.mdx b/src/pages/docs/chat/getting-started/swift-async-sequence.mdx index 03089809c3..24c21756a5 100644 --- a/src/pages/docs/chat/getting-started/swift-async-sequence.mdx +++ b/src/pages/docs/chat/getting-started/swift-async-sequence.mdx @@ -10,6 +10,10 @@ You'll learn how to create chat rooms, send and edit messages, and implement rea ![Screenshot of the completed Swift Chat application showing a web interface with connection status, a message input field, realtime message display, and a presence indicator showing online users. The interface demonstrates the key features you'll build including publishing messages, subscribing to receive messages in realtime, and tracking which clients are currently present in the channel.](../../../../images/content/screenshots/getting-started/chat-swift-getting-started-guide.png) + + ## Prerequisites ### Ably diff --git a/src/pages/docs/chat/getting-started/swift.mdx b/src/pages/docs/chat/getting-started/swift.mdx index 36b0252268..b9f46db09a 100644 --- a/src/pages/docs/chat/getting-started/swift.mdx +++ b/src/pages/docs/chat/getting-started/swift.mdx @@ -10,6 +10,10 @@ You'll learn how to create chat rooms, send and edit messages, and implement rea ![Screenshot of the completed Swift Chat application showing a web interface with connection status, a message input field, realtime message display, and a presence indicator showing online users. The interface demonstrates the key features you'll build including publishing messages, subscribing to receive messages in realtime, and tracking which clients are currently present in the channel.](../../../../images/content/screenshots/getting-started/chat-swift-getting-started-guide.png) + + ## Prerequisites ### Ably diff --git a/src/pages/docs/getting-started/dotnet.mdx b/src/pages/docs/getting-started/dotnet.mdx index c235dd4ec1..c51a2b4531 100644 --- a/src/pages/docs/getting-started/dotnet.mdx +++ b/src/pages/docs/getting-started/dotnet.mdx @@ -10,6 +10,10 @@ This guide will get you started with Ably Pub/Sub in C# .NET. You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history. + + ## Prerequisites 1. [Sign up](https://ably.com/sign-up) for an Ably account. diff --git a/src/pages/docs/getting-started/flutter.mdx b/src/pages/docs/getting-started/flutter.mdx index c3c4a5ccf3..cc2d52d10a 100644 --- a/src/pages/docs/getting-started/flutter.mdx +++ b/src/pages/docs/getting-started/flutter.mdx @@ -12,6 +12,10 @@ You'll establish a realtime connection to Ably and learn to publish and subscrib ![Screenshot of the completed Flutter Pub/Sub application showing a web interface with connection status, a message input field, realtime message display, and a presence indicator showing online users. The interface demonstrates the key features you'll build including publishing messages, subscribing to receive messages in realtime, and tracking which clients are currently present in the channel.](../../../images/content/screenshots/getting-started/pub-sub-flutter-getting-started-guide.png) + + ## Prerequisites 1. [Sign up](https://ably.com/sign-up) for a free Ably account. diff --git a/src/pages/docs/getting-started/go.mdx b/src/pages/docs/getting-started/go.mdx index 092eeb208d..960294a39f 100644 --- a/src/pages/docs/getting-started/go.mdx +++ b/src/pages/docs/getting-started/go.mdx @@ -8,6 +8,10 @@ This guide will get you started with Ably Pub/Sub in Go. You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history. + + ## Prerequisites 1. [Sign up](https://ably.com/signup) for an Ably account. diff --git a/src/pages/docs/getting-started/index.mdx b/src/pages/docs/getting-started/index.mdx index 3bfc41c640..49798638df 100644 --- a/src/pages/docs/getting-started/index.mdx +++ b/src/pages/docs/getting-started/index.mdx @@ -15,6 +15,10 @@ You'll learn the basics, such as how to connect to Ably, publish and subscribe t These are your first steps towards building a realtime application that can effortlessly scale to serve millions of users. + + {[ { diff --git a/src/pages/docs/getting-started/java.mdx b/src/pages/docs/getting-started/java.mdx index c5cc497dff..12942d0427 100644 --- a/src/pages/docs/getting-started/java.mdx +++ b/src/pages/docs/getting-started/java.mdx @@ -10,6 +10,10 @@ This guide will get you started with Ably Pub/Sub in Java. You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history. + + ## Prerequisites 1. [Sign up](https://ably.com/sign-up) for an Ably account. diff --git a/src/pages/docs/getting-started/javascript.mdx b/src/pages/docs/getting-started/javascript.mdx index 0300e7e89c..6cf1723ee0 100644 --- a/src/pages/docs/getting-started/javascript.mdx +++ b/src/pages/docs/getting-started/javascript.mdx @@ -8,6 +8,10 @@ This guide will get you started with Ably Pub/Sub in JavaScript. You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history. + + ## Prerequisites 1. [Sign up](https://ably.com/signup) for an Ably account. diff --git a/src/pages/docs/getting-started/kotlin.mdx b/src/pages/docs/getting-started/kotlin.mdx index d9e5df9b0a..9ca3556694 100644 --- a/src/pages/docs/getting-started/kotlin.mdx +++ b/src/pages/docs/getting-started/kotlin.mdx @@ -8,6 +8,10 @@ This guide will get you started with Ably Pub/Sub in Kotlin. You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history. + + ## Prerequisites 1. [Sign up](https://ably.com/signup) for an Ably account. diff --git a/src/pages/docs/getting-started/laravel.mdx b/src/pages/docs/getting-started/laravel.mdx index 42667c2ba3..ed90ca073f 100644 --- a/src/pages/docs/getting-started/laravel.mdx +++ b/src/pages/docs/getting-started/laravel.mdx @@ -10,6 +10,10 @@ You'll learn how to create a client and establish a connection to Ably using the ![Screenshot of the completed Laravel Pub/Sub application showing a web interface with a message input field and realtime message display. The interface demonstrates the key features you'll build including publishing messages and subscribing to receive messages in realtime.](../../../images/content/screenshots/getting-started/pub-sub-laravel-getting-started-guide.png) + + ## Prerequisites 1. [Sign up](https://ably.com/signup) for an Ably account. diff --git a/src/pages/docs/getting-started/node.mdx b/src/pages/docs/getting-started/node.mdx index 2bc3d5a7e7..b45fbd352e 100644 --- a/src/pages/docs/getting-started/node.mdx +++ b/src/pages/docs/getting-started/node.mdx @@ -8,6 +8,10 @@ This guide will get you started with Ably Pub/Sub in Node.js. You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history. + + ## Prerequisites 1. [Sign up](https://ably.com/signup) for an Ably account. diff --git a/src/pages/docs/getting-started/objective-c.mdx b/src/pages/docs/getting-started/objective-c.mdx index d1d3f41d19..6f050f1917 100644 --- a/src/pages/docs/getting-started/objective-c.mdx +++ b/src/pages/docs/getting-started/objective-c.mdx @@ -14,6 +14,10 @@ This guide will get you started with Ably Pub/Sub in Objective-C. You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history. + + ## Prerequisites 1. [Sign up](https://ably.com/sign-up) for an Ably account. diff --git a/src/pages/docs/getting-started/php.mdx b/src/pages/docs/getting-started/php.mdx index dc8b0d900a..3320f828e2 100644 --- a/src/pages/docs/getting-started/php.mdx +++ b/src/pages/docs/getting-started/php.mdx @@ -14,6 +14,10 @@ You'll learn how to connect to Ably using the REST SDK, generate JWTs for client This guide covers the Ably PHP SDK which provides RESTful functionality for publishing messages, retrieving history, and checking presence. If you need realtime features like subscribing to channels and receiving live updates, check out the [Ably Laravel broadcaster](https://github.com/ably/laravel-broadcaster) which integrates with Laravel's broadcasting system. + + ## Prerequisites 1. [Sign up](https://ably.com/signup) for an Ably account. diff --git a/src/pages/docs/getting-started/python.mdx b/src/pages/docs/getting-started/python.mdx index 85e63129eb..5be1b4b924 100644 --- a/src/pages/docs/getting-started/python.mdx +++ b/src/pages/docs/getting-started/python.mdx @@ -10,6 +10,10 @@ This guide will get you started with Ably Pub/Sub in Python. You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history. + + ## Prerequisites 1. [Sign up](https://ably.com/signup) for an Ably account. diff --git a/src/pages/docs/getting-started/react-native.mdx b/src/pages/docs/getting-started/react-native.mdx index bc49ab67c2..0744d3f17e 100644 --- a/src/pages/docs/getting-started/react-native.mdx +++ b/src/pages/docs/getting-started/react-native.mdx @@ -12,6 +12,10 @@ You'll establish a realtime connection to Ably and learn to publish and subscrib ![Screenshot of the completed React Native Pub/Sub application showing a web interface with connection status, a message input field, realtime message display, and a presence indicator showing online users. The interface demonstrates the key features you'll build including publishing messages, subscribing to receive messages in realtime, and tracking which clients are currently present in the channel.](../../../images/content/screenshots/getting-started/pub-sub-react-native-getting-started-guide.png) + + ## Prerequisites 1. [Sign up](https://ably.com/sign-up) for a free Ably account. diff --git a/src/pages/docs/getting-started/react.mdx b/src/pages/docs/getting-started/react.mdx index 5b465a54be..ee935ab7be 100644 --- a/src/pages/docs/getting-started/react.mdx +++ b/src/pages/docs/getting-started/react.mdx @@ -12,6 +12,10 @@ You'll establish a realtime connection to Ably and learn to publish and subscrib ![Screenshot of the completed React Pub/Sub application showing a web interface with connection status, a message input field, realtime message display, and a presence indicator showing online users. The interface demonstrates the key features you'll build including publishing messages, subscribing to receive messages in realtime, and tracking which clients are currently present in the channel.](../../../images/content/screenshots/getting-started/pub-sub-react-getting-started-guide.png) + + ## Prerequisites 1. [Sign up](https://ably.com/signup) for an Ably account. diff --git a/src/pages/docs/getting-started/ruby.mdx b/src/pages/docs/getting-started/ruby.mdx index 608c0a72b4..efd858bc4c 100644 --- a/src/pages/docs/getting-started/ruby.mdx +++ b/src/pages/docs/getting-started/ruby.mdx @@ -10,6 +10,10 @@ This guide will get you started with Ably Pub/Sub in a new Ruby application. You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history. + + ## Prerequisites 1. [Sign up](https://ably.com/sign-up) for an Ably account. diff --git a/src/pages/docs/getting-started/swift.mdx b/src/pages/docs/getting-started/swift.mdx index 2b33c2d6e3..dcf20e5b03 100644 --- a/src/pages/docs/getting-started/swift.mdx +++ b/src/pages/docs/getting-started/swift.mdx @@ -8,6 +8,10 @@ This guide will get you started with Ably Pub/Sub in a new Swift application bui You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history. + + ## Prerequisites 1. [Sign up](https://ably.com/signup) for an Ably account. diff --git a/src/pages/docs/platform/ai-llms/index.mdx b/src/pages/docs/platform/ai-llms/index.mdx index 94920a60b1..c7cd998c37 100644 --- a/src/pages/docs/platform/ai-llms/index.mdx +++ b/src/pages/docs/platform/ai-llms/index.mdx @@ -10,6 +10,45 @@ Ably documentation is designed to be LLM-friendly, making it easy to use AI assi If you're building AI-powered applications, see the [AI Transport](/docs/ai-transport) documentation for purpose-built infrastructure covering token streaming, session management, and human-in-the-loop workflows. +## Agent skills + +[Ably Agent Skills](https://github.com/ably/agent-skills) are packaged knowledge files that plug directly into all popular AI coding agents. They teach your agent how to use Ably correctly, covering product selection, authentication patterns, common pitfalls, and debugging workflows. + +### Install in Claude Code + +Add the Ably plugin marketplace and install the plugin: + + +```shell +claude plugin marketplace add ably/agent-skills +claude plugin install ably@ably-agent-skills +``` + + +You can also run these as slash commands from within a Claude Code session: + + +```shell +/plugin marketplace add ably/agent-skills +/plugin install ably@ably-agent-skills +``` + + +### Install in other AI coding agents + +For Cursor, Copilot, Windsurf, Gemini CLI, and other supported agents, use the cross-agent [skills CLI](https://agentskills.io): + + +```shell +npx skills add ably/agent-skills +``` + + +Two skills are included: + +- The `using-ably` skill guides code generation with product and SDK selection, authentication, React integration, and a post-generation validation checklist. It automatically fetches current docs from `llms.txt` before generating code. +- The `debugging-with-ably-cli` skill provides diagnostic decision trees for common issues such as messages not arriving, auth errors, and connection failures. It teaches your agent to use the [Ably CLI](https://github.com/ably/cli) for debugging. + ## Available resources Ably provides two key resources optimized for LLM consumption: @@ -36,9 +75,9 @@ https://ably.com/llms.txt Use this file to help your LLM discover relevant documentation pages. -## LLM configuration prompt +## Manual LLM configuration prompt -Copy the following prompt into your `CLAUDE.md`, `AGENTS.md`, Cursor rules, or other LLM configuration file to help AI assistants navigate Ably documentation effectively. This prompt uses less than 1600 tokens, accounting for ~0.8% of a typical 200k context window. +If you prefer not to use Agent Skills, or your AI tool doesn't support plugins, you can manually add the following prompt to your `CLAUDE.md`, `AGENTS.md`, Cursor rules, or other LLM configuration file. This prompt uses less than 1600 tokens, accounting for ~0.8% of a typical 200k context window. ```text diff --git a/src/pages/docs/push/getting-started/apns.mdx b/src/pages/docs/push/getting-started/apns.mdx index 089e4ab9f3..851cc0334c 100644 --- a/src/pages/docs/push/getting-started/apns.mdx +++ b/src/pages/docs/push/getting-started/apns.mdx @@ -8,6 +8,10 @@ This guide will get you started with Ably Push Notifications in a new SwiftUI ap You'll learn how to set up your `AppDelegate` to manage push notifications, register devices with Ably, send push notifications, subscribe to channel-based push, handle incoming notifications, and implement location-based push notifications. + + ## Prerequisites 1. [Sign up](https://ably.com/signup) for an Ably account. diff --git a/src/pages/docs/push/getting-started/fcm.mdx b/src/pages/docs/push/getting-started/fcm.mdx index 237d572f9c..c3d7e0a65c 100644 --- a/src/pages/docs/push/getting-started/fcm.mdx +++ b/src/pages/docs/push/getting-started/fcm.mdx @@ -8,6 +8,10 @@ This guide will get you started with Ably Push Notifications in a new Android ap You'll learn how to set up your application with Firebase Cloud Messaging (FCM), register devices with Ably, send push notifications, subscribe to channel-based push, and handle incoming notifications. + + ## Prerequisites 1. [Sign up](https://ably.com/signup) for an Ably account. diff --git a/src/pages/docs/push/getting-started/web.mdx b/src/pages/docs/push/getting-started/web.mdx index 1e373aa04f..97f9848b74 100644 --- a/src/pages/docs/push/getting-started/web.mdx +++ b/src/pages/docs/push/getting-started/web.mdx @@ -8,6 +8,10 @@ This guide will get you started with Ably Push Notifications in a web applicatio You'll learn how to set up an Ably Realtime client with push notification support, register a service worker, activate push notifications, subscribe to channel-based push, send push notifications, and handle incoming notifications in both the service worker and main page. + + ## Prerequisites 1. [Sign up](https://ably.com/signup) for an Ably account.