OpenCode セッション収集ガイド

目的

OpenCode のセッション情報を SDK / API で収集し、コンテキスト溢れを避けるために必要最小限のメッセージだけを抽出する。

使いどころ

• セッション一覧やセッション詳細を取得したい
• 特定のディレクトリやプロジェクトに関連するセッションを探したい
• メッセージ全量取得を避けたい（抽出スクリプトを推奨）

サーバー起動

サーバー未起動なら SDK で起動する。起動済みならクライアントのみ作る。

import { createOpencode, createOpencodeClient } from '@opencode-ai/sdk'

const opencode = await createOpencode()
const { client } = opencode

const clientOnly = createOpencodeClient({ baseUrl: 'http://localhost:4096' })

セッション収集フロー

1. セッション一覧を取得する
2. プロジェクトやディレクトリで絞り込む
3. 対象セッションのメッセージはスクリプトで必要分だけ抽出する

SDK

const sessions = await client.session.list()

API

curl -s "http://localhost:4096/session"

プロジェクト / ディレクトリで絞り込み

セッション一覧の projectID と directory で絞る。

プロジェクト一覧（任意）

const projects = await client.project.list()

フィルタ方針

• projectID が一致するセッションだけ残す
• directory が指定パスのプレフィックスなら対象にする

メッセージ抽出はスクリプト推奨

メッセージを直接 API で全量取得すると長くなり、コンテキストが溢れやすい。
同梱スクリプトで user 全件 + 最終 assistant 1件 のみを抽出する運用を推奨する。

スクリプト

config/opencode/skills/opencode-session-collector/scripts/extract-session-messages.js

例

node config/opencode/skills/opencode-session-collector/scripts/extract-session-messages.js \
  --base-url http://localhost:4096 \
  --project-id PROJECT_ID

node config/opencode/skills/opencode-session-collector/scripts/extract-session-messages.js \
  --dir-prefix /path/to/worktree

node config/opencode/skills/opencode-session-collector/scripts/extract-session-messages.js \
  --session-id SESSION_ID

出力形式

JSON でセッションごとの抽出結果を返す。

{
  "sessions": [
    {
      "session": {
        "id": "...",
        "title": "...",
        "directory": "...",
        "projectID": "...",
        "time": { "created": 0, "updated": 0 }
      },
      "messages": [
        { "role": "user", "time": { "created": 0 }, "text": "..." },
        { "role": "assistant", "time": { "created": 0 }, "text": "..." }
      ]
    }
  ]
}