opencode-codetime

CodeTime plugin for OpenCode -- track your AI coding activity and time spent.

Features

• Automatic time tracking -- sends coding events to CodeTime when OpenCode reads, edits, or writes files
• Check your coding time -- ask the AI "what's my coding time?" and it fetches your stats via the codetime tool
• Per-project filtering -- view coding time for the current project or any specific project
• Project breakdown -- see a ranked table of all projects with time spent today
• Language detection -- detects 90+ programming languages from file extensions
• Git integration -- captures current branch and remote origin
• Project identification -- shows as directory-name [opencode] on your CodeTime dashboard
• Rate-limited -- one heartbeat per 2 minutes to avoid API spam
• Session lifecycle -- flushes pending events on session end so no data is lost
• Zero config -- just set your token and go

Prerequisites

A CodeTime account. Sign up for free at codetime.dev.

Get your upload token from CodeTime Settings.

Installation

Via opencode config (recommended)

Add to your opencode.json:

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

From source

git clone https://github.com/roman-pinchuk/opencode-codetime
cd opencode-codetime
npm install && npm run build

Then copy the built files to your OpenCode plugins directory:

mkdir -p ~/.config/opencode/plugins
cp dist/*.js ~/.config/opencode/plugins/

Configuration

Set your CodeTime upload token as an environment variable:

export CODETIME_TOKEN="your-upload-token-here"

Add it to your shell profile (~/.bashrc, ~/.zshrc, etc.) to persist across sessions.

The plugin validates the token on startup and logs a warning if it is missing or invalid.

How It Works

The plugin hooks into OpenCode's event system to detect file activity.

OpenCode events                    Plugin                         CodeTime API
+-----------------------+     +------------------+     +------------------------+
| message.part.updated  | --> | Extract files    | --> | POST /v3/users/event-log|
| (edit, write, read,   |     | Detect language  |     |                        |
|  patch, multiedit)    |     | Rate limit (2m)  |     | { eventTime, language, |
+-----------------------+     +------------------+     |   project, relativeFile,|
| session.idle          | --> | Force flush      |     |   editor: "opencode",  |
| session.deleted       |     | pending events   |     |   platform, git info } |
+-----------------------+     +------------------+     +------------------------+

What gets tracked

Each heartbeat sent to CodeTime includes:

| Field | Value | |-------|-------| | eventTime | Unix timestamp of the event | | language | Detected from file extension (e.g. TypeScript, Python) | | project | directory-name [opencode] | | relativeFile | File path relative to the project root | | editor | opencode | | platform | OS platform (darwin, linux, windows) | | gitOrigin | Remote origin URL (if available) | | gitBranch | Current branch name (if available) |

Hooks used

| Hook | Purpose | |------|---------| | event | Listens for message.part.updated (tool completions) and session.idle/session.deleted (flush) | | chat.message | Processes pending heartbeats on chat activity | | tool | Registers codetime tool to check today's coding time |

Commands

| Command | Description | |---------|-------------| | /codetime | Show today's total coding time | | /codetime-breakdown | Show today's coding time broken down by project |

codetime tool

The codetime tool supports optional arguments for project filtering:

| Argument | Type | Description | |----------|------|-------------| | project | string (optional) | Filter by project name. Use "current" to auto-detect the current project. Omit to show total time. | | breakdown | boolean (optional) | When true, show a ranked breakdown of all projects. |

Usage examples (in natural language to the AI):

• "What's my coding time?" -- shows total time across all projects
• "How long have I been coding on this project?" -- shows time for the current project
• "Show me a breakdown of my coding time by project" -- shows ranked project list
• "How much time did I spend on my-app today?" -- shows time for a specific project

Example outputs:

# Total time (default)
Today's coding time: 2h 42m

# Current project
Today's coding time for opencode-codetime [opencode]: 1h 23m (Total across all projects: 2h 42m)

# Project breakdown
Today's coding time by project:

  opencode-codetime [opencode]    1h 23m
  my-other-project [vscode]         52m
  side-project [opencode]           27m
  ──────────────────────────────────────
  Total                           2h 42m

Tool tracking

| Tool | Data Extracted | |------|---------------| | read | File path from title | | edit | File path from filediff metadata | | write | File path from metadata | | patch | File paths from output | | multiedit | File paths from each edit result |

Project Structure

src/
  index.ts        Main plugin entry point with event hooks
  codetime.ts     CodeTime API client (token validation, heartbeats, stats)
  state.ts        Rate limiter (max 1 heartbeat per 2 minutes)
  language.ts     File extension to language name mapping
  git.ts          Git branch and remote origin extraction
  logger.ts       Structured logging via OpenCode SDK

Development

# Install dependencies
npm install

# Type check
npm run typecheck

# Build
npm run build

Troubleshooting

Plugin not loading

1. Verify opencode.json syntax
2. Check that CODETIME_TOKEN is set in your environment
3. Check OpenCode logs for opencode-codetime messages

Heartbeats not appearing in CodeTime

1. Verify your token at codetime.dev/dashboard/settings
2. Make sure you are editing files (not just chatting) -- heartbeats fire on tool completions
3. Wait up to 2 minutes for rate-limited heartbeats to flush
4. Check that the CodeTime API is reachable: curl -s https://api.codetime.dev/v3

Token validation fails

1. Regenerate your token at codetime.dev/dashboard/settings
2. Make sure the token has no leading/trailing whitespace

License

MIT