Skip to main content
Chatledger works by periodically polling the Antigravity IDE’s internal state to retrieve conversation histories. It then processes these conversations to generate clean, readable markdown files.

​
Automatic Export

When chatledger.enabled is set to true, the extension runs a background process that checks for changes every chatledger.pollInterval minutes.
1

Polling

The extension wakes up and queries the local Antigravity server for active conversations in your current workspace.
2

Change Detection

It calculates a hash of the conversation content. If the hash matches the last export, the step is skipped to avoid redundant writes.
3

Sanitization

The content is scanned for sensitive information using built-in and custom regex patterns.
4

Export

New or modified conversations are written to the configured exportDirectory (default: .chatledger).

​
Manual Export

You can trigger an export at any time, even if auto-export is disabled.
  1. Open the Command Palette (Ctrl+Shift+P).
  2. Run Chatledger: Export Now.

​
Export Format

Conversations are saved as Markdown files. The filename format is: {sanitized_summary}_{last_12_uuid_chars}.md

​
File Structure

Each exported file contains:
  • Metadata Table: Trajectory ID, total steps, start/end times.
  • User Request: The initial prompt or task description.
  • Context: <details> block showing active file and language context.
  • Agent Response: The agent’s thinking process and executed tools/actions.
# Fix Authentication Bug

## Metadata

| Field             | Value       |
| ----------------- | ----------- |
| **Trajectory ID** | `abc123...` |
| **Total Steps**   | 5           |

---

## User Request

Fix the login issue.

## Agent Response

### Thinking

Checking auth.ts...