OhMyC Timeline Plugin

Collects session data from Claude Code, OpenCode, and Codex agents and ingests it into the OhMyC Timeline dashboard.

Supported Agents

| Agent | Integration | Data Source | |-------|-------------|-------------| | Claude Code | Stop hook via hooks/hooks.json and hooks/ingest-claude.sh | Claude JSONL transcripts in ~/.claude/projects/ | | Codex | Codex plugin manifest, default hooks/hooks.json, and hooks/ingest-codex.sh | Codex JSONL sessions in ~/.codex/sessions/ and ~/.codex/archived_sessions/ | | OpenCode | OpenCode plugin entry at opencode.ts | Real-time OpenCode lifecycle, message, and tool events |

Requirements

• Node.js 22 or later for the Claude Code and Codex hook runtime.
• Bun 1.3.x when building from source or running the development test suite.
• jq is optional. Hook scripts use it for a faster transcript parse and fall back to Node when it is unavailable.
• One supported host: Claude Code, Codex, or OpenCode.

Quick Start

Install the plugin in the agent you use, then run a session normally. The plugin writes Timeline data to:

~/.config/ohmyc/timeline.db

Set OHMYC_HOME before starting the agent if you want the database somewhere else.

Installation

Claude Code

Claude Code installs plugins from marketplaces. Add this repository's marketplace and install the timeline plugin:

/plugin marketplace add JiangWeixian/ohmyc-plugins
/plugin install timeline@ohmyc

Official Claude Code plugin docs: https://code.claude.com/docs/en/discover-plugins

Codex

Codex also discovers plugins through marketplaces. Add this repository as a marketplace:

codex plugin marketplace add JiangWeixian/ohmyc-plugins

Then open the plugin browser and install OhMyC Timeline from the ohmyc marketplace:

codex
/plugins

Official Codex plugin docs: https://developers.openai.com/codex/plugins

OpenCode

OpenCode can load plugins from npm packages or local plugin files. If you use the package form, add the package name to opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@ohmyc/timeline-plugin"]
}

The plugin records session lifecycle, message, and tool events through OpenCode hooks.

Official OpenCode plugin docs: https://opencode.ai/docs/plugins/

Configuration

| Option | Type | Default | Example | Description | | --- | --- | --- | --- | --- | | OHMYC_HOME | environment variable | ~/.config/ohmyc | /tmp/ohmyc | Directory containing timeline.db. | | AGENT_HOME | environment variable | ~/.claude | /tmp/.claude | Claude transcript root used by ingest-claude.sh. | | CODEX_HOME | environment variable | ~/.codex | /tmp/.codex | Codex session root used by ingest-codex.sh. |

Contributing

For local setup, agent testing from a checkout, build commands, tests, commit style, and pull request expectations, see CONTRIBUTING.md.

Shared Output

All agents write to the same SQLite database:

~/.config/ohmyc/timeline.db

The shared writer contract is ParsedSessionData from @ohmyc/timeline. Agent-specific collectors normalize their native event or transcript format into that contract before writing.