diff --git a/docs/modules/kobiton-cli/pages/cli-commands.adoc b/docs/modules/kobiton-cli/pages/cli-commands.adoc index 4d3572768..0a42678f3 100644 --- a/docs/modules/kobiton-cli/pages/cli-commands.adoc +++ b/docs/modules/kobiton-cli/pages/cli-commands.adoc @@ -1,7 +1,14 @@ = Kobiton Command Line Interface commands :navtitle: Kobiton CLI commands -These are the commands you can use with the Kobiton Command Line Interface (CLI) tool. +Commands that operate on an active CLI session require session context. + +Provide session context using one of the following: + +* Pass the session token with the command: `--session-token ` (or `-a `) +* Set the `KOBITON_SESSION_TOKEN` environment variable + +The `` value is returned when you create a CLI session. For details, see xref:use-the-cli.adoc[Start using Kobiton CLI]. == `app run` diff --git a/docs/modules/kobiton-cli/pages/use-the-cli.adoc b/docs/modules/kobiton-cli/pages/use-the-cli.adoc index e83b99e78..f2ec0fb54 100644 --- a/docs/modules/kobiton-cli/pages/use-the-cli.adoc +++ b/docs/modules/kobiton-cli/pages/use-the-cli.adoc @@ -3,7 +3,7 @@ Learn how to use Kobiton Command Line Interface to control and operate your private device lab. -== Before you start +== Before you begin * xref:set-up-cli.adoc[Set up] Kobiton CLI. @@ -62,20 +62,38 @@ set KOBITON_SESSION_TOKEN= -- ==== -Most CLI commands require either `SESSION_ID` or `KOBITON_SESSION_TOKEN`. See xref:cli-commands.adoc[this page,window=read-later] for the list of commands and their basic usage. +== Use session context consistently + +After creating a CLI session, you receive both a `` and a ``. [NOTE] ==== +The *session ID* identifies the session record. The *session token* authorizes and scopes CLI commands to that session. +==== + +Many commands that operate on an active CLI session require session context. Provide session context using one of the following methods: + +* Pass the session token explicitly: `--session-token ` (or `-a `) +* Set the `KOBITON_SESSION_TOKEN` environment variable + +The session token ensures each command is applied to the intended active session. + +If you are running multiple sessions concurrently, always provide the session context explicitly. This prevents commands from being applied to the wrong session when more than one session is active. + +For interactive use, set `KOBITON_SESSION_TOKEN` once per terminal session. + +For scripts or isolated commands, pass `--session-token` explicitly with each command. + -* For CLI sessions: +== Known limitations -** No Session Explorer available. +* Session Explorer is not available when using Kobiton CLI. -** Session video and logs are not available in Session Overview. +* Session video and logs are not available in Session Overview. -** Mixed sessions between manual and CLI are not supported. +* Mixed sessions between manual testing and CLI testing are not supported. -** CLI sessions time out after 10 minutes by default and can be configured for up to 2 hours. You can reset the timeout using the `kobiton session ping` command. +* By default, CLI sessions time out after 10 minutes. You can configure the timeout up to 2 hours using the `kobiton session ping` command. ==== diff --git a/docs/modules/session-explorer/images/download-video.png b/docs/modules/session-explorer/images/download-video.png new file mode 100644 index 000000000..d0c475c8c Binary files /dev/null and b/docs/modules/session-explorer/images/download-video.png differ diff --git a/docs/modules/session-explorer/pages/analytics/use-the-session-timeline.adoc b/docs/modules/session-explorer/pages/analytics/use-the-session-timeline.adoc index 147c76756..fda13a094 100644 --- a/docs/modules/session-explorer/pages/analytics/use-the-session-timeline.adoc +++ b/docs/modules/session-explorer/pages/analytics/use-the-session-timeline.adoc @@ -43,6 +43,19 @@ To download a screenshot, select a test step in the timeline, then select the *D image:session-explorer:download-screenshot-closeup.png[width=500,alt="Download button to download screenshot of the selected step"] +=== Download video of test session + +To download a video of your test session, open *Session Overview* and select the *Download* icon in the upper-right corner of the video player. + +image:session-explorer:download-video.png[width=500,alt="Download video of test session"] + +[NOTE] +==== +Videos played in QuickTime may appear jittery. This playback issue is specific to QuickTime and does not reflect the actual test session. + +For accurate playback, use the VLC media player. +==== + === View accessibility issues To view an accessibility issue automatically flagged during your session, select a *yellow marker* in the timeline.