> ## 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.

# Claude Code

> Set up AgentLogs with Claude Code for automatic transcript capture

# Claude Code Integration

Claude Code is Anthropic's official CLI for Claude. AgentLogs provides deep integration with Claude Code, including automatic transcript sync and commit tracking.

## Features

* **Automatic sync** - Transcripts are uploaded automatically at the end of each session
* **Commit tracking** - Links AI sessions to the git commits they produced

## Installation

### 1. Authentication

Run the following command in the terminal:

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

### 2. Claude Code Plugin

Inside Claude Code, run the following commands:

```bash theme={null}
/plugin marketplace add agentlogs/claude-code
/plugin install agentlogs
```

## How It Works

The plugin captures transcripts and tracks commits using Claude Code hooks:

* **Stop** - Captures after each agent response (real-time visibility)
* **SessionEnd** - Captures complete session (guaranteed final state)
* **PreToolUse** - Runs before Bash commands to snapshot git state
* **PostToolUse** - Runs after Bash commands to detect new commits

Transcripts are automatically deduplicated server-side based on session ID.

The PreToolUse and PostToolUse hooks work together to track commits: PreToolUse captures the current HEAD before a Bash command runs, and PostToolUse compares it after to detect any commits made by Claude Code.

## Manual Upload

You can manually upload transcripts using the CLI:

```bash theme={null}
# Interactive picker to browse and upload any transcript
npx agentlogs upload

# Upload a specific transcript file
npx agentlogs claudecode upload ~/.claude/projects/-path-to-project/session-id.jsonl

# Sync all transcripts from a specific project
npx agentlogs claudecode sync --cwd /path/to/project
```

The interactive `upload` command discovers transcripts from all agents and lets you pick one to upload.