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

# Usage

> Use the AgentLogs CLI

# Usage

The AgentLogs CLI is the primary way to sync transcripts from AI coding assistants to your AgentLogs account. No installation required — just run it with `npx`.

## Requirements

* Node.js 18+ or Bun 1.3.10+
* macOS, Linux, or Windows

## Authentication

Before syncing, you need to log in to your AgentLogs account:

```bash theme={null}
npx agentlogs login <hostname>
```

For production:

```bash theme={null}
npx agentlogs login agentlogs.ai
```

This initiates a device authorization flow:

1. The CLI displays a user code
2. A browser window opens to the verification URL
3. Enter the code and authorize the device
4. The CLI receives an access token and stores it locally

## Check Status

Verify you're logged in:

```bash theme={null}
npx agentlogs status
```

This shows, per configured host:

* Authentication status
* Logged-in user details
* Last login time

## Logout

To log out and remove stored credentials:

```bash theme={null}
npx agentlogs logout [hostname]
```

* With hostname: logs out from that host only
* Without hostname: logs out from all hosts