You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/pages/docs/platform/tools/cli.mdx
+7-9Lines changed: 7 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,7 +27,7 @@ npx -p @ably/cli ably init
27
27
28
28
[`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.
29
29
30
-
If you'd rather install the CLI yourself before running `init`, the Ably CLI is published to NPM:
30
+
To install the CLI manually first, use npm and then run `ably init`:
31
31
32
32
<Code>
33
33
```shell
@@ -37,20 +37,18 @@ ably init
37
37
</Code>
38
38
39
39
<Asidedata-type='note'>
40
-
Alternatively, you can skip interactive `ably init`or`ably login` commands by using [environment variables](/docs/cli/env) to authenticate directly in scripts and CI/CD pipelines.
40
+
Alternatively, you can skip the interactive `ably init`and`ably login` commands by using [environment variables](/docs/cli/env) to authenticate directly in scripts and CI/CD pipelines.
41
41
</Aside>
42
42
43
43
## Usage
44
44
45
-
`ably init`authenticates using an [OAuth Device Authorization](https://datatracker.ietf.org/doc/html/rfc8628) flow: the CLI displays an authorization code and opens your browser to approve it. Once approved, the CLI receives an [access token](/docs/platform/account/access-tokens) that is stored locally and refreshed automatically, so there is no manual token management.
45
+
During `ably init`, the CLI authenticates using an [OAuth Device Authorization](https://datatracker.ietf.org/doc/html/rfc8628) flow: it displays an authorization code and opens your browser to approve it. Once approved, the CLI receives an [access token](/docs/platform/account/access-tokens) that is stored locally and refreshed automatically, so there is no manual token management.
46
46
47
47
If you only need to authenticate, without installing Agent Skills, run [`ably login`](/docs/cli/login) instead.
48
48
49
-
After you have successfully authenticated and chosen your app and API key, you're ready to interact with Ably resources directly from your terminal.
49
+
After authenticating and selecting your app and API key, you can interact with Ably resources directly from your terminal.
50
50
51
-
For example, open two terminal instances and subscribe to one, and publish messages in the other:
52
-
53
-
To subscribe:
51
+
For example, open two terminal windows. In the first, subscribe to a channel:
0 commit comments