Skip to main content

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.

Metadata

Release files for opencode-log 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for opencode-log 0.3.1
File Size Uploaded Provenance
opencode_log-0.3.1.tar.gz 85.4 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for opencode-log 0.3.1
File Interpreter ABI Platform
opencode_log-0.3.1-py3-none-any.whl Python 3 none any Details

Total release size: 151.4 kB

Release files / opencode_log-0.3.1.tar.gz

Download URL opencode_log-0.3.1.tar.gz
Size 85.4 kB
Tags Source
SHA-256 checksum
How to use checksums
25d5bbf96a4d11ebd903c7ad614e3ae63b0646fa985043e234f87685837779c4
BLAKE2b-256 checksum
How to use checksums
f4463ee6b5354cd67593bfc5c3b328215be431a9e5db535fce340843ecad99f5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 19, 2026.

Transparency log

Release files / opencode_log-0.3.1-py3-none-any.whl

Download URL opencode_log-0.3.1-py3-none-any.whl
Size 66.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
636e7efc540d290c0771ef7dfded1099468ebf50103a43567d0e368a87746d81
BLAKE2b-256 checksum
How to use checksums
81ac18ed592b8462f1fce7288df270aec70f1ef302066b5d355b124557d0b4c7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 19, 2026.

Transparency log

Security for opencode-log 0.3.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for opencode_log-0.3.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

0.3.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page