> For the complete documentation index, see [llms.txt](https://docs.sealights.io/knowledgebase/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sealights.io/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent-1.5/command-line-reference/sealights.md).

# SeaLights

The `sealights` commands let you connect the ABAP Agent to SeaLights, test the connection, and list the connection details.

## Connect the ABAP Agent to SeaLights

The `sealights set` command uses a SeaLights Agent Token to connect the ABAP Agent to SeaLights. The connection allows the ABAP Agent to send an initial snapshot of your SAP systems to SeaLights, followed by the changes introduced into your system by SAP transports.

The `sealights set` command requires a SeaLights Agent token. It stores the agent token in your `config.toml` file in an encrypted format, and runs the `sealights test` command to test the connection to SeaLights.

{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Syntax" overflow="wrap" %}

```batch
slabapcli.exe sealights set
```

{% endcode %}
{% endtab %}

{% tab title="PowerShell" %}
{% code title="Syntax" overflow="wrap" %}

```powershell
.\slabapcli.exe sealights set
```

{% endcode %}
{% endtab %}
{% endtabs %}

This command takes no parameters.

### Example

{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}

```log
.\slabapcli.exe sealights set
[2026-04-21 08:51:38.306+01:00] [info] Config pathname: ..\config\config.toml
Enter token:
Confirm token:
Token accepted (a3f***...***d2b).
Running 'sealights test' to verify the new token...
[2026-04-21 08:51:47.710+01:00] [info] Test SeaLights: customer.sealights.io
  Agent token is valid.
  Sealights connectivity check succeeded.
```

{% endcode %}

## Test the connection

The `sealights test` command tests the ABAP Agent's connection to SeaLights. The `sealights set` command runs this command automatically to verify the connection. You can run `sealights test` manually if you need to reverify the connection without changing the agent token.

{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Syntax" overflow="wrap" %}

```batch
slabapcli.exe sealights test
```

{% endcode %}
{% endtab %}

{% tab title="PowerShell" %}
{% code title="Syntax" overflow="wrap" %}

```powershell
.\slabapcli.exe sealights test
```

{% endcode %}
{% endtab %}
{% endtabs %}

This command takes no parameters.

{% hint style="info" %}
**TODO (from v1.5 draft):** The source Syntax block for this command showed `sealights set` / `setup set`. Corrected to `sealights test` — please confirm.
{% endhint %}

### Example

{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}

```log
.\slabapcli.exe sealights test
[2026-04-21 09:11:54.006+01:00] [info] Config pathname: ..\config\config.toml
[2026-04-21 09:11:54.013+01:00] [info] Test SeaLights: customer.sealights.io
Agent token is valid.
Sealights connectivity check succeeded.
```

{% endcode %}

## List the connection details

The `sealights list` command lists the ABAP Agent's SeaLights connection details.

{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Syntax" overflow="wrap" %}

```batch
slabapcli.exe sealights list
```

{% endcode %}
{% endtab %}

{% tab title="PowerShell" %}
{% code title="Syntax" overflow="wrap" %}

```powershell
.\slabapcli.exe sealights list
```

{% endcode %}
{% endtab %}
{% endtabs %}

This command takes no parameters.

{% hint style="info" %}
**TODO (from v1.5 draft):** The source Example for `sealights list` showed the output of `sealights test`. Placeholder output below needs to be replaced with real `sealights list` output.
{% endhint %}

### Example

{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}

```log
.\slabapcli.exe sealights list
[2026-04-21 09:11:54.006+01:00] [info] Config pathname: ..\config\config.toml
[2026-04-21 09:11:54.013+01:00] [info] Test SeaLights: customer.sealights.io
Agent token is valid.
Sealights connectivity check succeeded.
```

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sealights.io/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent-1.5/command-line-reference/sealights.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
