Skip to main content

​
OpenCode Integration

OpenCode is an open-source AI coding assistant. AgentLogs provides integration with OpenCode for automatic transcript sync.

​
Features

  • Automatic sync - Transcripts are uploaded automatically when the session becomes idle
  • Git commit enhancement - Automatically adds transcript links to git commit messages
  • Commit tracking - Tracks which commits were made during each session

​
Installation

​
1. Authentication

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

​
2. Configure OpenCode

Add the plugin to your opencode.json config file: 
{
  "plugin": ["@agentlogs/opencode"]
}
The plugin will be automatically installed via npm on next OpenCode startup.

​
How It Works

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

​
Transcript Upload

When a session becomes idle, the plugin 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 plugin 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.

​
Manual Upload

You can manually upload transcripts using the CLI: 
# Interactive picker to browse and upload any transcript
npx agentlogs upload

# Filter to only OpenCode transcripts
npx agentlogs upload --source opencode

# Upload a specific session by ID
npx agentlogs opencode upload <sessionId>
The interactive upload command discovers transcripts from all agents and lets you pick one to upload. Sessions are read from ~/.local/share/opencode/storage/.