Skip to main content

​
Pi Integration

Pi is an open-source AI coding agent. AgentLogs provides an extension for Pi that automatically uploads transcripts and enhances git commits with transcript links.

​
Features

  • Automatic sync - Transcripts are uploaded automatically when you exit a session
  • Git commit enhancement - Automatically adds transcript links to git commit messages
  • Commit tracking - Tracks which commits were made during each session
  • Branch-aware - Properly handles Pi’s conversation branching feature

​
Installation

​
1. Authentication

Run the following command in the terminal: 
npx agentlogs login agentlogs.ai

​
2. Install the Extension

Run inside Pi or from the terminal: 
pi install npm:@agentlogs/pi
This installs the package and registers the extension automatically. It will be loaded on next Pi startup.

​
How It Works

The extension is lightweight and shells out to the AgentLogs CLI for all processing:

​
Transcript Upload

When you exit a Pi session (Ctrl+D), the extension triggers the CLI to upload the transcript. Transcripts are automatically deduplicated server-side based on session ID.

​
Git Commit Enhancement

When a git commit is detected:
  1. The extension intercepts the command before execution
  2. Generates a stable transcript ID
  3. Appends a transcript link to the commit message
  4. Uploads a partial transcript so the link works immediately
Example commit message: 
Fix authentication bug

🔮 View transcript: https://agentlogs.ai/s/abc123xyz

​
Commit Tracking

After a git commit completes, the CLI extracts the commit SHA, branch, and title, then associates them with the transcript for easy navigation.

​
Branch Handling

Pi supports conversation branching via the /tree command. The extension handles this by:
  • Generating unique transcript IDs for each branch
  • Only uploading the current branch (from leaf to root)

​
Manual Upload

You can manually upload transcripts using the CLI: 
# Upload a specific session by ID
npx agentlogs pi upload <sessionId>

# Upload from a session file path
npx agentlogs pi upload /path/to/session.jsonl

# Interactive picker (all agents)
npx agentlogs upload --source pi
Sessions are read from ~/.pi/agent/sessions/.