> ## Documentation Index
> Fetch the complete documentation index at: https://platform.atlan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# atlanai trace

> Install integrations and inspect local trace capture, delivery, data, and runtime state.

Trace capture records finalized coding-agent sessions locally and exports them
as OpenTelemetry traces through the background daemon.

The trace namespace delegates to the runtime command parser. Run the exact
operation shown below; nested operations do not expose separate Cobra flag
tables.

## Commands

### integration

Lists, checks, installs, or removes supported coding-agent integrations.

**Usage**

```text theme={null}
atlanai trace integration list
atlanai trace integration doctor
atlanai trace integration install <sources...>
atlanai trace integration uninstall <sources...>
```

`<sources...>` accepts supported coding-agent sources such as `claude` and
`codex`. `install` adds only Atlan-managed hook entries; `uninstall` removes
only those owned entries. `doctor` verifies the installed integration state.

### session

Lists locally captured sessions for a selected time window.

**Usage**

```text theme={null}
atlanai trace session list [7d|30d|all]
```

The optional window defaults to the runtime's standard recent range.

### import

Starts or manages a local session import.

**Usage**

```text theme={null}
atlanai trace import start <source> [session-id...]
atlanai trace import status <id>
atlanai trace import cancel <id>
atlanai trace import retry <id>
```

`start` can import discovered sessions from a source or selected session IDs.
The returned import ID is used by `status`, `cancel`, and `retry`.

### reconcile

Forces the daemon to rescan local content and redrive pending work.

**Usage**

```text theme={null}
atlanai trace reconcile
```

The rescan redrives skill upload, repository onboarding, and session backfill
immediately.

### config

Shows or changes local trace-content capture policy.

**Usage**

```text theme={null}
atlanai trace config show
atlanai trace config set capture.store-content <true|false>
```

The content setting controls whether supported message content is retained in
captured trace data. Review the resolved policy before enabling it.

### data

Shows local trace-storage state or removes reclaimable payload data.

**Usage**

```text theme={null}
atlanai trace data status
atlanai trace data purge
```

`status` reports the local journal and outbox. Treat `purge` as destructive.

### outbox

Shows delivery state or moves compatible dead-letter items back into delivery.

**Usage**

```text theme={null}
atlanai trace outbox status
atlanai trace outbox requeue-dlq
```

### runtime

Shows runtime state or activates the previously retained runtime version.

**Usage**

```text theme={null}
atlanai trace runtime status
atlanai trace runtime rollback
```

`status` also reports the last auto-update result. `rollback` does not delete
the journal.

### support

Writes an installation diagnostics bundle.

**Usage**

```text theme={null}
atlanai trace support bundle [path]
```

The default path is chosen by the runtime when `[path]` is omitted.

## Examples

```bash theme={null}
atlanai trace integration install claude codex
atlanai trace session list 7d
atlanai trace import start claude-code
atlanai trace outbox status
atlanai trace reconcile
```

## Output and behavior

* Trace commands operate on the local runtime, journal, integrations, and
  delivery state. Commands that export or retry work can contact the Gateway.
* The active Registry context does not set trace attribution; capture resolves
  its own workspace and identity.
* Integration changes preserve unrelated coding-agent configuration.
* Purge changes local data, rollback changes the active runtime, and DLQ
  requeue changes delivery state. Inspect status first.
* Review support bundles before sharing them outside your organization.

## Related

* [Capture coding-agent traces](/cli/traces)
* [Diagnose the CLI](/cli/diagnostics)
* [`atlanai logs`](/cli/reference/logs)
* [`atlanai auth`](/cli/reference/auth)