opencode-codetime 0.1.0 → 0.3.0

package/README.md

@@ -1,12 +1,20 @@
 # opencode-codetime
 
+[![npm version](https://img.shields.io/npm/v/opencode-codetime)](https://www.npmjs.com/package/opencode-codetime)
+[![npm downloads](https://img.shields.io/npm/dm/opencode-codetime)](https://www.npmjs.com/package/opencode-codetime)
+[![license](https://img.shields.io/npm/l/opencode-codetime)](https://github.com/roman-pinchuk/opencode-codetime/blob/main/LICENSE)
+[![GitHub release](https://img.shields.io/github/v/release/roman-pinchuk/opencode-codetime)](https://github.com/roman-pinchuk/opencode-codetime/releases)
+[![CI](https://img.shields.io/github/actions/workflow/status/roman-pinchuk/opencode-codetime/publish.yml?label=publish)](https://github.com/roman-pinchuk/opencode-codetime/actions)
+
 [CodeTime](https://codetime.dev) plugin for [OpenCode](https://github.com/anomalyco/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
 - **Language detection** -- detects 90+ programming languages from file extensions
 - **Git integration** -- captures current branch and remote origin
+- **Project identification** -- shows as `[opencode] project-name` 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
@@ -81,7 +89,7 @@ Each heartbeat sent to CodeTime includes:
 |-------|-------|
 | `eventTime` | Unix timestamp of the event |
 | `language` | Detected from file extension (e.g. `TypeScript`, `Python`) |
-| `project` | Current directory name |
+| `project` | `[opencode] directory-name` |
 | `relativeFile` | File path relative to the project root |
 | `editor` | `opencode` |
 | `platform` | OS platform (`darwin`, `linux`, `windows`) |
@@ -94,6 +102,7 @@ Each heartbeat sent to CodeTime includes:
 |------|---------|
 | `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 |
 
 ### Tool tracking
 

package/dist/index.js

@@ -1,6 +1,7 @@
 import * as os from "node:os";
 import * as path from "node:path";
-import { sendHeartbeat, validateToken, } from "./codetime.js";
+import { tool } from "@opencode-ai/plugin/tool";
+import { sendHeartbeat, validateToken, getTodayMinutes, } from "./codetime.js";
 import { getGitBranch, getGitOrigin } from "./git.js";
 import { detectLanguage } from "./language.js";
 import { initLogger, info, warn, error, debug } from "./logger.js";
@@ -9,11 +10,14 @@ import { initState, shouldSendHeartbeat, updateLastHeartbeat, } from "./state.js
 const processedCallIds = new Set();
 const pendingFiles = new Map();
 let _token = null;
+let _client = null;
 let _projectName = "unknown";
 let _projectDir = "";
 let _worktree = "";
+let _shellFn = null;
 let _gitOrigin = null;
 let _gitBranch = null;
+let _gitInfoFetched = false;
 let _platform = os.platform();
 // ---- File extraction from tool events ----
 function extractFilesFromTool(tool, metadata, output, title) {
@@ -80,6 +84,20 @@ function computeRelativeFile(absoluteFile, projectDir) {
     }
     return path.basename(absoluteFile);
 }
+// ---- Lazy git info ----
+async function ensureGitInfo() {
+    if (_gitInfoFetched || !_shellFn || !_worktree)
+        return;
+    _gitInfoFetched = true;
+    try {
+        _gitOrigin = await getGitOrigin(_shellFn, _worktree);
+        _gitBranch = await getGitBranch(_shellFn, _worktree);
+        await debug("Git info", { origin: _gitOrigin, branch: _gitBranch }).catch(() => { });
+    }
+    catch {
+        // Git info is optional, continue without it
+    }
+}
 // ---- Heartbeat processing ----
 async function processHeartbeats(force = false) {
     if (!_token)
@@ -88,6 +106,7 @@ async function processHeartbeats(force = false) {
         return;
     if (pendingFiles.size === 0)
         return;
+    await ensureGitInfo();
     const promises = [];
     for (const [filePath, fileInfo] of pendingFiles.entries()) {
         const relativeFile = computeRelativeFile(filePath, _projectDir);
@@ -134,6 +153,18 @@ function pruneProcessedIds() {
         }
     }
 }
+// ---- Time formatting ----
+function formatMinutes(minutes) {
+    if (minutes < 1)
+        return "0m";
+    const hours = Math.floor(minutes / 60);
+    const mins = Math.round(minutes % 60);
+    if (hours === 0)
+        return `${mins}m`;
+    if (mins === 0)
+        return `${hours}h`;
+    return `${hours}h ${mins}m`;
+}
 // ---- Plugin entry point ----
 export const plugin = async (ctx) => {
     try {
@@ -164,17 +195,13 @@ export const plugin = async (ctx) => {
         }).catch(() => { });
         // Initialize state
         initState();
+        _client = client;
         _projectDir = directory;
         _worktree = worktree;
-        _projectName = path.basename(directory);
+        _projectName = `${path.basename(directory)} [opencode]`;
         _platform = os.platform();
-        // Fetch git info
-        if (worktree) {
-            const shellFn = $;
-            _gitOrigin = await getGitOrigin(shellFn, worktree);
-            _gitBranch = await getGitBranch(shellFn, worktree);
-            await debug("Git info", { origin: _gitOrigin, branch: _gitBranch }).catch(() => { });
-        }
+        // Store shell function for lazy git info fetching
+        _shellFn = $;
         return {
             event: async ({ event }) => {
                 try {
@@ -231,6 +258,68 @@ export const plugin = async (ctx) => {
                     await error("Chat message handler error", { error: String(err) }).catch(() => { });
                 }
             },
+            "command.execute.before": async (input, output) => {
+                try {
+                    if (input.command !== "codetime")
+                        return;
+                    if (!_token || !_client) {
+                        await _client?.tui.showToast({
+                            body: { message: "CodeTime: token not configured", variant: "error" },
+                        }).catch(() => { });
+                        output.parts.push({
+                            type: "text",
+                            text: "CodeTime is not configured. Set `CODETIME_TOKEN` environment variable to enable tracking.\nGet your token from https://codetime.dev/dashboard/settings",
+                        });
+                        return;
+                    }
+                    const minutes = await getTodayMinutes(_token);
+                    if (minutes === null) {
+                        await _client.tui.showToast({
+                            body: { message: "CodeTime: failed to fetch data", variant: "error" },
+                        }).catch(() => { });
+                        output.parts.push({
+                            type: "text",
+                            text: "Failed to fetch coding time from CodeTime API.",
+                        });
+                        return;
+                    }
+                    const formatted = formatMinutes(minutes);
+                    await _client.tui.showToast({
+                        body: { message: `CodeTime: ${formatted} today`, variant: "success" },
+                    }).catch(() => { });
+                    output.parts.push({
+                        type: "text",
+                        text: `Today's coding time: ${formatted}`,
+                    });
+                }
+                catch (err) {
+                    await error("Command handler error", { error: String(err) }).catch(() => { });
+                }
+            },
+            tool: {
+                codetime: tool({
+                    description: "Show today's coding time tracked by CodeTime. " +
+                        "Use this when the user asks about their coding time, " +
+                        "how long they've been coding, or wants to see their CodeTime stats.",
+                    args: {},
+                    async execute() {
+                        if (!_token) {
+                            return "CodeTime is not configured. Set CODETIME_TOKEN environment variable to enable tracking. Get your token from https://codetime.dev/dashboard/settings";
+                        }
+                        try {
+                            const minutes = await getTodayMinutes(_token);
+                            if (minutes === null) {
+                                return "Failed to fetch coding time from CodeTime API.";
+                            }
+                            const formatted = formatMinutes(minutes);
+                            return `Today's coding time: ${formatted}`;
+                        }
+                        catch (err) {
+                            return `Failed to fetch coding time: ${String(err)}`;
+                        }
+                    },
+                }),
+            },
         };
     }
     catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-codetime",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "CodeTime plugin for OpenCode - Track AI coding activity and time spent with codetime.dev",
   "type": "module",
   "main": "dist/index.js",