opencode-codetime 0.2.0 → 0.4.1

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/git.d.ts

@@ -1,15 +1,10 @@
-interface ShellFn {
-    (strings: TemplateStringsArray, ...values: unknown[]): Promise<{
-        stdout: Buffer;
-        exitCode: number;
-    }>;
-}
 /**
  * Extract git remote origin URL from the worktree.
+ * Uses node:child_process directly to avoid OpenCode TUI shell flash.
  */
-export declare function getGitOrigin($: ShellFn, worktree: string): Promise<string | null>;
+export declare function getGitOrigin(worktree: string): Promise<string | null>;
 /**
  * Extract the current git branch from the worktree.
+ * Uses node:child_process directly to avoid OpenCode TUI shell flash.
  */
-export declare function getGitBranch($: ShellFn, worktree: string): Promise<string | null>;
-export {};
+export declare function getGitBranch(worktree: string): Promise<string | null>;

package/dist/git.js

@@ -1,32 +1,42 @@
-import * as debug from "./logger.js";
+import { execFile as execFileCb } from "node:child_process";
+import { promisify } from "node:util";
+const execFile = promisify(execFileCb);
 /**
  * Extract git remote origin URL from the worktree.
+ * Uses node:child_process directly to avoid OpenCode TUI shell flash.
  */
-export async function getGitOrigin($, worktree) {
+export async function getGitOrigin(worktree) {
     try {
-        const result = await $ `git -C ${worktree} config --get remote.origin.url 2>/dev/null`;
-        if (result.exitCode === 0) {
-            return result.stdout.toString().trim() || null;
-        }
+        const { stdout } = await execFile("git", [
+            "-C",
+            worktree,
+            "config",
+            "--get",
+            "remote.origin.url",
+        ]);
+        return stdout.trim() || null;
     }
     catch {
-        await debug.debug("Failed to get git origin", { worktree });
+        return null;
     }
-    return null;
 }
 /**
  * Extract the current git branch from the worktree.
+ * Uses node:child_process directly to avoid OpenCode TUI shell flash.
  */
-export async function getGitBranch($, worktree) {
+export async function getGitBranch(worktree) {
     try {
-        const result = await $ `git -C ${worktree} rev-parse --abbrev-ref HEAD 2>/dev/null`;
-        if (result.exitCode === 0) {
-            const branch = result.stdout.toString().trim();
-            return branch && branch !== "HEAD" ? branch : null;
-        }
+        const { stdout } = await execFile("git", [
+            "-C",
+            worktree,
+            "rev-parse",
+            "--abbrev-ref",
+            "HEAD",
+        ]);
+        const branch = stdout.trim();
+        return branch && branch !== "HEAD" ? branch : null;
     }
     catch {
-        await debug.debug("Failed to get git branch", { worktree });
+        return null;
     }
-    return null;
 }

package/dist/index.js

@@ -15,6 +15,7 @@ let _projectDir = "";
 let _worktree = "";
 let _gitOrigin = null;
 let _gitBranch = null;
+let _gitInfoFetched = false;
 let _platform = os.platform();
 // ---- File extraction from tool events ----
 function extractFilesFromTool(tool, metadata, output, title) {
@@ -81,6 +82,20 @@ function computeRelativeFile(absoluteFile, projectDir) {
     }
     return path.basename(absoluteFile);
 }
+// ---- Lazy git info ----
+async function ensureGitInfo() {
+    if (_gitInfoFetched || !_worktree)
+        return;
+    _gitInfoFetched = true;
+    try {
+        _gitOrigin = await getGitOrigin(_worktree);
+        _gitBranch = await getGitBranch(_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)
@@ -89,6 +104,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);
@@ -150,7 +166,7 @@ function formatMinutes(minutes) {
 // ---- Plugin entry point ----
 export const plugin = async (ctx) => {
     try {
-        const { client, directory, worktree, $ } = ctx;
+        const { client, directory, worktree } = ctx;
         // Initialize logger (may fail if client shape differs)
         try {
             initLogger(client);
@@ -179,15 +195,8 @@ export const plugin = async (ctx) => {
         initState();
         _projectDir = directory;
         _worktree = worktree;
-        _projectName = `[opencode] ${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(() => { });
-        }
         return {
             event: async ({ event }) => {
                 try {
@@ -244,6 +253,15 @@ export const plugin = async (ctx) => {
                     await error("Chat message handler error", { error: String(err) }).catch(() => { });
                 }
             },
+            config: async (cfg) => {
+                cfg.command = cfg.command || {};
+                cfg.command["codetime"] = {
+                    description: "Show today's coding time from CodeTime",
+                    template: "Retrieve current CodeTime coding time stats.\n\n" +
+                        "Immediately call `codetime` with no arguments and return its output verbatim.\n" +
+                        "Do not call other tools.",
+                };
+            },
             tool: {
                 codetime: tool({
                     description: "Show today's coding time tracked by CodeTime. " +

package/package.json

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