oclog

OpenCode session log viewer — tail, follow, search, and export your OpenCode session logs from the terminal.

Install

npm install -g oclog

Quick Start

oclog                                    # list recent sessions
oclog <session-id>                       # view session (tail mode)
oclog <session-id> --all                 # full session export
oclog -f <session-id>                    # follow session (live tail)
oclog <keyword>                          # search by title/ID
oclog <session-id> -o session.md         # export to markdown file
oclog <session-id> -j                    # raw JSON export

Commands

Command	Description
oclog	List the 10 most recent sessions
oclog <target>	View session (tail last 10 messages by default)
oclog <target> --all	View full session
oclog -f <target>	Follow session live (polls every 2s)
oclog <target> -n <N>	Tail last N messages
oclog <target> -j	Export session as JSON
oclog <target> -o <file>	Write session to file

<target> can be a full session ID, an ID prefix, or a title keyword.

Options

Flag	Description
-n, --tail <N>	Number of messages to show (default: 10)
-a, --all	Show all messages
-f, --follow	Follow session live
-j, --json	Output raw JSON
-r, --raw	Raw markdown output (no ANSI colors)
-e, --expand	Expand truncated content, show reasoning
-p, --pager	Use pager (less)
-o, --output <file>	Write output to file
-i, --interval <sec>	Follow poll interval (default: 2)
--version	Show version
--help	Show help

Development

git clone <repo-url>
cd oclog
npm install
npm run dev          # run via tsx (no build needed)
npm test             # run tests
npm run lint         # type check
npm run build        # build to dist/

Tech Stack

• TypeScript (strict mode)
• chalk — terminal colors
• tsup — bundler
• vitest — test framework

License

MIT