Skip to main content

Generate browsable HTML logs from OpenCode local data

Project description

opencode-log

opencode-log is a CLI tool that converts local OpenCode sessions into interactive, searchable HTML/Markdown logs.

It now reads data directly from OpenCode's SQLite database (opencode.db) by default.

PyPI version License: MIT CI Wheel

中文文档: README.zh.md

Key Features

  • Interactive timeline, search, and message-type filtering
  • Rich rendering for text, code, reasoning, and tool calls
  • OpenCode-specific support for todos, session diffs, tokens, and cost
  • Incremental rendering with cache for faster regeneration

Install

Recommended: run directly with uvx.

uvx opencode-log

Or install with pip:

pip install opencode-log

Quick Start

# Process all projects (default: opens browser)
opencode-log

# Explicitly point to OpenCode data directory (contains opencode.db)
opencode-log --storage-dir ~/.local/share/opencode

# Or point directly to the database file
opencode-log --storage-dir ~/.local/share/opencode/opencode.db

# Process all projects without opening browser
opencode-log --no-open-browser

# Filter by date with natural language
opencode-log --from-date "7 days ago" --to-date "today"

# Generate both HTML and Markdown
opencode-log --format both

Contact

📫ChengAo: chengao_shen@ieee.org

License

MIT. See LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

opencode_log-0.3.1.tar.gz (85.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

opencode_log-0.3.1-py3-none-any.whl (66.0 kB view details)

Uploaded Python 3

File details

Details for the file opencode_log-0.3.1.tar.gz.

File metadata

  • Download URL: opencode_log-0.3.1.tar.gz
  • Upload date:
  • Size: 85.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for opencode_log-0.3.1.tar.gz
Algorithm Hash digest
SHA256 25d5bbf96a4d11ebd903c7ad614e3ae63b0646fa985043e234f87685837779c4
MD5 7d33186f3a246e361ed66f46186c97e6
BLAKE2b-256 f4463ee6b5354cd67593bfc5c3b328215be431a9e5db535fce340843ecad99f5

See more details on using hashes here.

Provenance

The following attestation bundles were made for opencode_log-0.3.1.tar.gz:

Publisher: release.yml on CatVinci-Studio/opencode-log

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file opencode_log-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: opencode_log-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 66.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for opencode_log-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 636e7efc540d290c0771ef7dfded1099468ebf50103a43567d0e368a87746d81
MD5 211c7b151b4674b973fd1b93bfc981bc
BLAKE2b-256 81ac18ed592b8462f1fce7288df270aec70f1ef302066b5d355b124557d0b4c7

See more details on using hashes here.

Provenance

The following attestation bundles were made for opencode_log-0.3.1-py3-none-any.whl:

Publisher: release.yml on CatVinci-Studio/opencode-log

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page