docs: link ably init to its CLI reference page

umair-ably · claude · umair-ably · commit d6c15ad9ddd5 · 2026-05-14T15:28:44.000+01:00
Co-Authored-By: Claude Opus 4.7 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/src/pages/docs/chat/getting-started/android.mdx b/src/pages/docs/chat/getting-started/android.mdx
@@ -44,7 +44,7 @@ implementation("com.ably.chat:chat-extensions-compose:1.2.0")
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test chat features. It can simulate other users by sending messages, entering presence, and acting as another user typing a message.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/chat/getting-started/javascript.mdx b/src/pages/docs/chat/getting-started/javascript.mdx
@@ -62,7 +62,7 @@ echo "ABLY_API_KEY={{API_KEY}}" > .env
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test chat features. It can simulate other users by sending messages, entering presence, and acting as another user typing a message.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/chat/getting-started/jvm.mdx b/src/pages/docs/chat/getting-started/jvm.mdx
@@ -59,7 +59,7 @@ implementation("org.slf4j:slf4j-nop:2.0.17")
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test chat features. It can simulate other users by sending messages, entering presence, and acting as another user typing a message.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/chat/getting-started/react-native.mdx b/src/pages/docs/chat/getting-started/react-native.mdx
@@ -53,7 +53,7 @@ cd ios && pod install && cd ..
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test chat features. It can simulate other users by sending messages, entering presence, and acting as another user typing a message.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/chat/getting-started/react-ui-kit.mdx b/src/pages/docs/chat/getting-started/react-ui-kit.mdx
@@ -67,7 +67,7 @@ That's all the setup you need—the kit's CSS is automatically bundled by Vite a
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test chat features. It can simulate other users by sending messages, entering presence, and acting as another user typing a message.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/chat/getting-started/react.mdx b/src/pages/docs/chat/getting-started/react.mdx
@@ -60,7 +60,7 @@ echo "VITE_ABLY_API_KEY={{API_KEY}}" > .env
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test chat features. It can simulate other users by sending messages, entering presence, and acting as another user typing a message.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/chat/getting-started/swift-async-sequence.mdx b/src/pages/docs/chat/getting-started/swift-async-sequence.mdx
@@ -25,7 +25,7 @@ Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skill
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test chat features. It can simulate other users by sending messages, entering presence, and acting as another user typing a message.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/chat/getting-started/swift.mdx b/src/pages/docs/chat/getting-started/swift.mdx
@@ -25,7 +25,7 @@ Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skill
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test chat features. It can simulate other users by sending messages, entering presence, and acting as another user typing a message.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/getting-started/dotnet.mdx b/src/pages/docs/getting-started/dotnet.mdx
@@ -41,7 +41,7 @@ dotnet add package ably.io
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features. It can simulate other clients by publishing messages, subscribing to channels, and managing presence states.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/getting-started/flutter.mdx b/src/pages/docs/getting-started/flutter.mdx
@@ -167,7 +167,7 @@ Initialize the Ably service at the application level to prevent it from being re
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features. It can simulate other clients by publishing messages, subscribing to channels, and managing presence states.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/getting-started/go.mdx b/src/pages/docs/getting-started/go.mdx
@@ -34,7 +34,7 @@ go get -u github.com/ably/ably-go/ably
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features. It can simulate other clients by publishing messages, subscribing to channels, and managing presence states.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/getting-started/java.mdx b/src/pages/docs/getting-started/java.mdx
@@ -52,7 +52,7 @@ Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skill
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features. It can simulate other clients by publishing messages, subscribing to channels, and managing presence states.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/getting-started/javascript.mdx b/src/pages/docs/getting-started/javascript.mdx
@@ -26,7 +26,7 @@ Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skill
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features. It can simulate other clients by publishing messages, subscribing to channels, and managing presence states.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/getting-started/kotlin.mdx b/src/pages/docs/getting-started/kotlin.mdx
@@ -31,7 +31,7 @@ implementation("io.ably:ably-java:<latest-version>")
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features. It can simulate other clients by publishing messages, subscribing to channels, and managing presence states.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/getting-started/laravel.mdx b/src/pages/docs/getting-started/laravel.mdx
@@ -50,7 +50,7 @@ npm run dev
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features. It can simulate other clients by publishing messages, subscribing to channels, and managing presence states.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/getting-started/nextjs.mdx b/src/pages/docs/getting-started/nextjs.mdx
@@ -86,7 +86,7 @@ npm install ably
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features. It can simulate other clients by publishing messages, subscribing to channels, and managing presence states.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/getting-started/node.mdx b/src/pages/docs/getting-started/node.mdx
@@ -44,7 +44,7 @@ echo "ABLY_API_KEY={{API_KEY}}" > .env
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features. It can simulate other clients by publishing messages, subscribing to channels, and managing presence states.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/getting-started/objective-c.mdx b/src/pages/docs/getting-started/objective-c.mdx
@@ -46,7 +46,7 @@ https://github.com/ably/ably-cocoa
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features. It can simulate other clients by publishing messages, subscribing to channels, and managing presence states.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/getting-started/php.mdx b/src/pages/docs/getting-started/php.mdx
@@ -44,7 +44,7 @@ composer require ably/ably-php
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features. It can simulate other clients by publishing messages, subscribing to channels, and managing presence states.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/getting-started/python.mdx b/src/pages/docs/getting-started/python.mdx
@@ -41,7 +41,7 @@ pip install ably
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features. It can simulate other clients by publishing messages, subscribing to channels, and managing presence states.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/getting-started/react-native.mdx b/src/pages/docs/getting-started/react-native.mdx
@@ -145,7 +145,7 @@ Keep the Realtime client initialization outside of any React component to preven
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features. It can simulate other clients by publishing messages, subscribing to channels, and managing presence states.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/getting-started/react.mdx b/src/pages/docs/getting-started/react.mdx
@@ -153,7 +153,7 @@ Keep the Realtime client initialization outside of any React component to preven
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features. It can simulate other clients by publishing messages, subscribing to channels, and managing presence states.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/getting-started/ruby.mdx b/src/pages/docs/getting-started/ruby.mdx
@@ -39,7 +39,7 @@ The realtime interface of the Ruby SDK must be run within an [EventMachine](http
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features. It can simulate other clients by publishing messages, subscribing to channels, and managing presence states.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/getting-started/swift.mdx b/src/pages/docs/getting-started/swift.mdx
@@ -37,7 +37,7 @@ dependencies: [
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features. It can simulate other clients by publishing messages, subscribing to channels, and managing presence states.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/platform/tools/cli.mdx b/src/pages/docs/platform/tools/cli.mdx
@@ -25,7 +25,7 @@ npx -p @ably/cli ably init
 ```
 </Code>
 
-`ably init` installs the Ably CLI globally, authenticates you, and installs the Ably [Agent Skills](https://github.com/ably/agent-skills) into any AI coding tools it detects on your machine, such as Claude Code, Cursor, VS Code, and Windsurf.
+[`ably init`](/docs/cli/init) installs the Ably CLI globally, authenticates you, and installs the Ably [Agent Skills](https://github.com/ably/agent-skills) into any AI coding tools it detects on your machine, such as Claude Code, Cursor, VS Code, and Windsurf.
 
 If you'd rather install the CLI yourself before running `init`, the Ably CLI is published to NPM:
 
diff --git a/src/pages/docs/push/getting-started/apns.mdx b/src/pages/docs/push/getting-started/apns.mdx
@@ -27,7 +27,7 @@ then enable the Push notifications option. See [rules](/docs/channels#rules) for
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features and push notifications.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/push/getting-started/fcm.mdx b/src/pages/docs/push/getting-started/fcm.mdx
@@ -25,7 +25,7 @@ Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skill
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features and push notifications.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/push/getting-started/flutter.mdx b/src/pages/docs/push/getting-started/flutter.mdx
@@ -22,7 +22,7 @@ You'll learn how to configure Firebase Cloud Messaging (FCM) for Android and APN
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features and push notifications.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code fixed="true">
 ```shell
diff --git a/src/pages/docs/push/getting-started/react-native.mdx b/src/pages/docs/push/getting-started/react-native.mdx
@@ -24,7 +24,7 @@ You'll learn how to set up your application with Firebase Cloud Messaging (FCM),
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features and push notifications.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
diff --git a/src/pages/docs/push/getting-started/web.mdx b/src/pages/docs/push/getting-started/web.mdx
@@ -26,7 +26,7 @@ then enable the Push notifications option. See [rules](/docs/channels#rules) for
 
 Use the [Ably CLI](/docs/platform/tools/cli) as an additional client to quickly test Pub/Sub features and push notifications.
 
-Install the Ably CLI, authenticate, and set the default app and API key in a single command:
+[`ably init`](/docs/cli/init) installs the Ably CLI, authenticates, and sets the default app and API key in a single command:
 
 <Code>
 ```shell
