{
  "info": {
    "title": "<brief task description>",
    "agent": "opencode",
    "models": ["<model(s) used>"]
  },
  "summary": [
    "<action 1>",
    "<action 2>",
    ...
  ]
}

Workflow

1. Export Session Data

Get session data using OpenCode CLI:

opencode export [sessionID]

Returns JSON with session info including models used. Use current session if no sessionID provided.

2. Generate Summary JSON

From exported data and conversation context, create summary:

title: 2-5 word task description (lowercase)
agent: always "opencode"
models: array from export data
summary: array of terse action statements
- Use past tense ("added", "fixed", "created")
- Start with "user requested..." or "user asked..."
- Chronological order
- Attempt to keep the summary to a max of 25 turns ("user requested", "agent did")
- NEVER include sensitive data: API keys, credentials, secrets, tokens, passwords, env vars

3. Update PR/MR Description

GitHub:

gh pr edit <PR_NUMBER> --body "$(cat <<'EOF'
<existing description>

> [!NOTE]
> This PR was written with AI assistance.

<details><summary>AI Session Export</summary>
...
</details>
EOF
)"

GitLab:

glab mr update <MR_NUMBER> --description "$(cat <<'EOF'
<existing description>

> [!NOTE]
> This MR was written with AI assistance.

<details><summary>AI Session Export</summary>
...
</details>
EOF
)"

4. Preserve Existing Content

Always fetch and preserve existing PR/MR description:

# GitHub
gh pr view <PR_NUMBER> --json body -q '.body'

# GitLab

Append session export after existing content with blank line separator.

Example Summary

For a session where user asked to add dark mode:

{
  "info": {
    "title": "dark mode implementation",
    "agent": "opencode",
    "models": ["claude sonnet 4"]
  },
  "summary": [
    "user requested dark mode toggle in settings",
    "agent explored existing theme system",
    "agent created ThemeContext for state management",
    "agent added DarkModeToggle component",
    "agent updated CSS variables for dark theme",
    "agent ran tests and fixed 2 failures",
    "agent committed changes"
  ]
}

Security

NEVER include in summary:

API keys, tokens, secrets
Passwords, credentials
Environment variable values
Private URLs with auth tokens
Personal identifiable information
Internal hostnames/IPs

session-export

Session Export

Output Format