opencode-codetime 0.3.0 → 0.5.0

package/README.md

@@ -8,13 +8,17 @@
 
 [CodeTime](https://codetime.dev) plugin for [OpenCode](https://github.com/anomalyco/opencode) -- track your AI coding activity and time spent.
 
+<img width="885" height="312" alt="image" src="https://github.com/user-attachments/assets/5f15a838-af86-4d4c-ab07-a9e467779bca" />
+
 ## 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 `[opencode] project-name` on your CodeTime dashboard
+- **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
@@ -89,7 +93,7 @@ Each heartbeat sent to CodeTime includes:
 |-------|-------|
 | `eventTime` | Unix timestamp of the event |
 | `language` | Detected from file extension (e.g. `TypeScript`, `Python`) |
-| `project` | `[opencode] directory-name` |
+| `project` | `directory-name [opencode]` |
 | `relativeFile` | File path relative to the project root |
 | `editor` | `opencode` |
 | `platform` | OS platform (`darwin`, `linux`, `windows`) |
@@ -104,6 +108,48 @@ Each heartbeat sent to CodeTime includes:
 | `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 |
@@ -119,7 +165,7 @@ Each heartbeat sent to CodeTime includes:
 ```
 src/
   index.ts        Main plugin entry point with event hooks
-  codetime.ts     CodeTime API client (token validation, heartbeats)
+  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

package/dist/codetime.d.ts

@@ -28,3 +28,25 @@ export declare function sendHeartbeat(token: string, event: EventLogRequest): Pr
  * Fetch today's coding minutes from CodeTime API.
  */
 export declare function getTodayMinutes(token: string): Promise<number | null>;
+export interface StatsTimeData {
+    duration: number;
+    time: string;
+}
+export interface StatsTimeResponse {
+    data: StatsTimeData[];
+}
+export interface TopEntry {
+    field: string;
+    minutes: number;
+}
+/**
+ * Fetch coding minutes for a specific project using the stats_time endpoint.
+ * Returns total minutes for the project within the last 24 hours,
+ * or a custom time range if start/end are provided.
+ */
+export declare function getProjectMinutes(token: string, project: string): Promise<number | null>;
+/**
+ * Fetch top projects by coding time using the top endpoint.
+ * Returns a ranked list of projects with their minutes.
+ */
+export declare function getTopProjects(token: string, minutes?: number): Promise<TopEntry[] | null>;

package/dist/codetime.js

@@ -83,3 +83,77 @@ export async function getTodayMinutes(token) {
         return null;
     }
 }
+/**
+ * Fetch coding minutes for a specific project using the stats_time endpoint.
+ * Returns total minutes for the project within the last 24 hours,
+ * or a custom time range if start/end are provided.
+ */
+export async function getProjectMinutes(token, project) {
+    try {
+        const params = new URLSearchParams({
+            project,
+            unit: "minutes",
+            limit: "1440",
+        });
+        const response = await fetch(`${API_BASE}/v3/users/self/stats_time?${params.toString()}`, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            await logger.warn("Failed to fetch project minutes", {
+                status: response.status,
+                statusText: response.statusText,
+                project,
+            });
+            return null;
+        }
+        const data = (await response.json());
+        // Sum all duration values from the response
+        const totalMinutes = data.data.reduce((sum, entry) => sum + entry.duration, 0);
+        return totalMinutes;
+    }
+    catch (err) {
+        await logger.error("Project minutes request failed", {
+            error: String(err),
+            project,
+        });
+        return null;
+    }
+}
+/**
+ * Fetch top projects by coding time using the top endpoint.
+ * Returns a ranked list of projects with their minutes.
+ */
+export async function getTopProjects(token, minutes = 1440) {
+    try {
+        const params = new URLSearchParams({
+            field: "workspace",
+            minutes: String(minutes),
+        });
+        const response = await fetch(`${API_BASE}/v3/users/self/top?${params.toString()}`, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            await logger.warn("Failed to fetch top projects", {
+                status: response.status,
+                statusText: response.statusText,
+            });
+            return null;
+        }
+        const data = (await response.json());
+        return data;
+    }
+    catch (err) {
+        await logger.error("Top projects request failed", {
+            error: String(err),
+        });
+        return null;
+    }
+}

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

@@ -1,7 +1,7 @@
 import * as os from "node:os";
 import * as path from "node:path";
 import { tool } from "@opencode-ai/plugin/tool";
-import { sendHeartbeat, validateToken, getTodayMinutes, } from "./codetime.js";
+import { sendHeartbeat, validateToken, getTodayMinutes, getProjectMinutes, getTopProjects, } from "./codetime.js";
 import { getGitBranch, getGitOrigin } from "./git.js";
 import { detectLanguage } from "./language.js";
 import { initLogger, info, warn, error, debug } from "./logger.js";
@@ -10,11 +10,9 @@ 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;
@@ -86,12 +84,12 @@ function computeRelativeFile(absoluteFile, projectDir) {
 }
 // ---- Lazy git info ----
 async function ensureGitInfo() {
-    if (_gitInfoFetched || !_shellFn || !_worktree)
+    if (_gitInfoFetched || !_worktree)
         return;
     _gitInfoFetched = true;
     try {
-        _gitOrigin = await getGitOrigin(_shellFn, _worktree);
-        _gitBranch = await getGitBranch(_shellFn, _worktree);
+        _gitOrigin = await getGitOrigin(_worktree);
+        _gitBranch = await getGitBranch(_worktree);
         await debug("Git info", { origin: _gitOrigin, branch: _gitBranch }).catch(() => { });
     }
     catch {
@@ -168,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);
@@ -195,13 +193,10 @@ export const plugin = async (ctx) => {
         }).catch(() => { });
         // Initialize state
         initState();
-        _client = client;
         _projectDir = directory;
         _worktree = worktree;
         _projectName = `${path.basename(directory)} [opencode]`;
         _platform = os.platform();
-        // Store shell function for lazy git info fetching
-        _shellFn = $;
         return {
             event: async ({ event }) => {
                 try {
@@ -258,55 +253,78 @@ 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(() => { });
-                }
+            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.",
+                };
+                cfg.command["codetime-breakdown"] = {
+                    description: "Show today's coding time breakdown by project",
+                    template: "Retrieve CodeTime coding time stats broken down by project.\n\n" +
+                        'Immediately call `codetime` with `breakdown: true` and return its output verbatim.\n' +
+                        "Do not call other tools.",
+                };
             },
             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() {
+                        "how long they've been coding, or wants to see their CodeTime stats. " +
+                        "Supports filtering by project name and showing a breakdown of time across all projects.",
+                    args: {
+                        project: tool.schema.string().optional().describe("Filter by project name. Use 'current' to auto-detect the current project. " +
+                            "Omit to show total time across all projects."),
+                        breakdown: tool.schema.boolean().optional().describe("When true, show a breakdown of coding time across all projects today."),
+                    },
+                    async execute(args) {
                         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 {
+                            // Breakdown mode: show all projects ranked by time
+                            if (args.breakdown) {
+                                const projects = await getTopProjects(_token);
+                                if (projects === null || projects.length === 0) {
+                                    return "No project data available for today.";
+                                }
+                                // Calculate total
+                                const totalMinutes = projects.reduce((sum, p) => sum + p.minutes, 0);
+                                // Find the longest project name for alignment
+                                const maxNameLen = Math.max(...projects.map((p) => p.field.length), "Total".length);
+                                const lines = ["Today's coding time by project:", ""];
+                                for (const p of projects) {
+                                    const name = p.field.padEnd(maxNameLen + 2);
+                                    lines.push(`  ${name}${formatMinutes(p.minutes)}`);
+                                }
+                                lines.push(`  ${"─".repeat(maxNameLen + 2 + 8)}`);
+                                lines.push(`  ${"Total".padEnd(maxNameLen + 2)}${formatMinutes(totalMinutes)}`);
+                                return lines.join("\n");
+                            }
+                            // Project-specific mode
+                            const projectName = args.project === "current" ? _projectName : args.project;
+                            if (projectName) {
+                                // Fetch both project-specific and total in parallel
+                                const [projectMins, totalMins] = await Promise.all([
+                                    getProjectMinutes(_token, projectName),
+                                    getTodayMinutes(_token),
+                                ]);
+                                if (projectMins === null) {
+                                    return `Failed to fetch coding time for project "${projectName}" from CodeTime API.`;
+                                }
+                                const projectFormatted = formatMinutes(projectMins);
+                                const displayName = args.project === "current"
+                                    ? _projectName
+                                    : projectName;
+                                if (totalMins !== null) {
+                                    const totalFormatted = formatMinutes(totalMins);
+                                    return `Today's coding time for ${displayName}: ${projectFormatted} (Total across all projects: ${totalFormatted})`;
+                                }
+                                return `Today's coding time for ${displayName}: ${projectFormatted}`;
+                            }
+                            // Default: total coding time (original behavior)
                             const minutes = await getTodayMinutes(_token);
                             if (minutes === null) {
                                 return "Failed to fetch coding time from CodeTime API.";

package/package.json

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