opencode-usage-stats 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenUsage
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,56 @@
+# OpenCodeUsage
+
+An OpenCode plugin that surfaces local usage statistics (sessions, messages, tokens, cost, model/tool breakdown) and reserves a hook for cloud plan/remaining-quota information once OpenCode exposes a public API for it.
+
+## Install
+
+Add the plugin to your OpenCode config (`opencode.json` or `~/.config/opencode/opencode.json`):
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-usage-stats"]
+}
+```
+
+OpenCode will install the npm package automatically on startup.
+
+## Use
+
+In any OpenCode session, ask the agent to show your usage:
+
+```
+Show my OpenCode usage
+```
+
+The agent will call the custom `usage` tool and return a markdown summary.
+
+## Configuration
+
+```json
+{
+  "plugin": ["opencode-usage-stats"],
+  "opencode-usage-stats": {
+    "enableCloudApi": false,
+    "cloudApiUrl": "https://console.opencode.ai/api/usage",
+    "apiKey": ""
+  }
+}
+```
+
+- `enableCloudApi`: When `true`, the plugin attempts to fetch cloud plan/usage data. Currently this is a placeholder because OpenCode does not expose a public usage API.
+- `cloudApiUrl`: Reserved URL for the future cloud usage endpoint.
+- `apiKey`: Reserved API key for the future cloud usage endpoint.
+
+## Data sources
+
+- **C-1 (enabled by default)**: Aggregates local usage by reading the running OpenCode session list via the OpenCode SDK (`client.session.list()` / `client.session.messages()`).
+- **C-2 (placeholder)**: Will call the configured cloud usage API when OpenCode releases a public endpoint. Until then, it is disabled and the plugin reports the limitation.
+
+## Repository
+
+https://github.com/QianYuan1437/OpenUsage
+
+## License
+
+MIT

package/dist/api.d.ts

@@ -0,0 +1,29 @@
+import type { OpenCodeUsageConfig } from "./config.js";
+/**
+ * Cloud usage response shape.
+ *
+ * This is intentionally generic because OpenCode does not currently expose a
+ * public REST endpoint for plan/usage data. When such an API becomes available,
+ * this interface can be tightened to match the real schema.
+ */
+export interface CloudUsageInfo {
+    plan?: string;
+    monthlyLimit?: number;
+    monthlyUsed?: number;
+    remaining?: number;
+    billingPeriod?: string;
+    currency?: string;
+    estimatedCost?: number;
+}
+/**
+ * Fetch usage information from a cloud usage API.
+ *
+ * Currently this is a placeholder. The official OpenCode project does not
+ * expose a public REST endpoint for billing/usage/remaining quota. When it does,
+ * implement the real network call here and flip `enableCloudApi` to `true` in
+ * your OpenCode config.
+ *
+ * @returns Cloud usage data, or `null` if not available.
+ */
+export declare function fetchCloudUsage(_config: Required<OpenCodeUsageConfig>): Promise<CloudUsageInfo | null>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GACrC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAOhC"}

package/dist/api.js

@@ -0,0 +1,19 @@
+/**
+ * Fetch usage information from a cloud usage API.
+ *
+ * Currently this is a placeholder. The official OpenCode project does not
+ * expose a public REST endpoint for billing/usage/remaining quota. When it does,
+ * implement the real network call here and flip `enableCloudApi` to `true` in
+ * your OpenCode config.
+ *
+ * @returns Cloud usage data, or `null` if not available.
+ */
+export async function fetchCloudUsage(_config) {
+    // Placeholder: C-2 is reserved but not enabled by default.
+    // Real implementation should:
+    // 1. Validate config.apiKey and config.cloudApiUrl
+    // 2. Make an authenticated request to the usage endpoint
+    // 3. Parse and return the response
+    return null;
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAmBA;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAsC;IAEtC,2DAA2D;IAC3D,8BAA8B;IAC9B,mDAAmD;IACnD,yDAAyD;IACzD,mCAAmC;IACnC,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,28 @@
+import type { PluginOptions } from "@opencode-ai/plugin";
+/**
+ * Configuration shape for the OpenCodeUsage plugin.
+ *
+ * This is read from the OpenCode config under the `OpenCodeUsage` key,
+ * e.g.:
+ *
+ * ```json
+ * {
+ *   "plugin": ["OpenCodeUsage"],
+ *   "OpenCodeUsage": {
+ *     "enableCloudApi": false,
+ *     "cloudApiUrl": "https://console.opencode.ai/api/usage",
+ *     "apiKey": ""
+ *   }
+ * }
+ * ```
+ */
+export interface OpenCodeUsageConfig {
+    /** When true, attempt to call the cloud usage API (C-2). Default false (C-1). */
+    enableCloudApi?: boolean;
+    /** Base URL for the cloud usage API. Reserved for future OpenCode usage endpoints. */
+    cloudApiUrl?: string;
+    /** API key for the cloud usage API. Reserved for future use. */
+    apiKey?: string;
+}
+export declare function resolveConfig(options?: PluginOptions): Required<OpenCodeUsageConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAC,mBAAmB,CAAC,CAOpF"}

package/dist/config.js

@@ -0,0 +1,9 @@
+export function resolveConfig(options) {
+    const cfg = (options ?? {});
+    return {
+        enableCloudApi: cfg.enableCloudApi ?? false,
+        cloudApiUrl: cfg.cloudApiUrl ?? "https://console.opencode.ai/api/usage",
+        apiKey: cfg.apiKey ?? "",
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AA4BA,MAAM,UAAU,aAAa,CAAC,OAAuB;IACnD,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAwB,CAAA;IAClD,OAAO;QACL,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,KAAK;QAC3C,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,uCAAuC;QACvE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;KACzB,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { Plugin } from "@opencode-ai/plugin";
+declare const OpenCodeUsage: Plugin;
+export default OpenCodeUsage;
+export { OpenCodeUsage };
+export * from "./api.js";
+export * from "./config.js";
+export * from "./usage.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAA8B,MAAM,qBAAqB,CAAA;AAM7E,QAAA,MAAM,aAAa,EAAE,MAuDpB,CAAA;eAEc,aAAa;AAC5B,OAAO,EAAE,aAAa,EAAE,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,63 @@
+import { tool } from "@opencode-ai/plugin";
+import { fetchCloudUsage } from "./api.js";
+import { resolveConfig } from "./config.js";
+import { aggregateUsage, formatUsage } from "./usage.js";
+const OpenCodeUsage = async (input, options) => {
+    const config = resolveConfig(options);
+    const { client } = input;
+    return {
+        tool: {
+            usage: tool({
+                description: "Show OpenCode usage statistics (sessions, messages, tokens, cost, model/tool breakdown). " +
+                    "When OpenCode exposes a cloud usage API, this can also show plan limits and remaining quota.",
+                args: {
+                    cloud: tool.schema
+                        .boolean()
+                        .optional()
+                        .describe("Force fetch cloud usage information if available."),
+                },
+                async execute(args) {
+                    const wantsCloud = args.cloud ?? config.enableCloudApi;
+                    if (wantsCloud) {
+                        const cloud = await fetchCloudUsage(config);
+                        if (cloud) {
+                            return {
+                                title: "OpenCode Cloud Usage",
+                                output: [
+                                    "## OpenCode Cloud Usage",
+                                    "",
+                                    `- Plan: ${cloud.plan ?? "unknown"}`,
+                                    `- Billing Period: ${cloud.billingPeriod ?? "unknown"}`,
+                                    `- Monthly Limit: ${cloud.monthlyLimit ?? "unknown"}`,
+                                    `- Monthly Used: ${cloud.monthlyUsed ?? "unknown"}`,
+                                    `- Remaining: ${cloud.remaining ?? "unknown"}`,
+                                    `- Estimated Cost: ${cloud.estimatedCost !== undefined ? `$${cloud.estimatedCost.toFixed(4)}` : "unknown"}`,
+                                ].join("\n"),
+                            };
+                        }
+                    }
+                    try {
+                        const stats = await aggregateUsage(client);
+                        return {
+                            title: "OpenCode Usage",
+                            output: formatUsage(stats),
+                        };
+                    }
+                    catch (error) {
+                        const message = error instanceof Error ? error.message : String(error);
+                        return {
+                            title: "OpenCode Usage Error",
+                            output: `Failed to gather OpenCode usage statistics.\n\n${message}\n\nMake sure OpenCode is running and the plugin has access to its local API.`,
+                        };
+                    }
+                },
+            }),
+        },
+    };
+};
+export default OpenCodeUsage;
+export { OpenCodeUsage };
+export * from "./api.js";
+export * from "./config.js";
+export * from "./usage.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExD,MAAM,aAAa,GAAW,KAAK,EAAE,KAAkB,EAAE,OAAuB,EAAE,EAAE;IAClF,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;IACrC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IAExB,OAAO;QACL,IAAI,EAAE;YACJ,KAAK,EAAE,IAAI,CAAC;gBACV,WAAW,EACT,2FAA2F;oBAC3F,8FAA8F;gBAChG,IAAI,EAAE;oBACJ,KAAK,EAAE,IAAI,CAAC,MAAM;yBACf,OAAO,EAAE;yBACT,QAAQ,EAAE;yBACV,QAAQ,CAAC,mDAAmD,CAAC;iBACjE;gBACD,KAAK,CAAC,OAAO,CAAC,IAAI;oBAChB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,cAAc,CAAA;oBAEtD,IAAI,UAAU,EAAE,CAAC;wBACf,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,CAAA;wBAC3C,IAAI,KAAK,EAAE,CAAC;4BACV,OAAO;gCACL,KAAK,EAAE,sBAAsB;gCAC7B,MAAM,EAAE;oCACN,yBAAyB;oCACzB,EAAE;oCACF,WAAW,KAAK,CAAC,IAAI,IAAI,SAAS,EAAE;oCACpC,qBAAqB,KAAK,CAAC,aAAa,IAAI,SAAS,EAAE;oCACvD,oBAAoB,KAAK,CAAC,YAAY,IAAI,SAAS,EAAE;oCACrD,mBAAmB,KAAK,CAAC,WAAW,IAAI,SAAS,EAAE;oCACnD,gBAAgB,KAAK,CAAC,SAAS,IAAI,SAAS,EAAE;oCAC9C,qBAAqB,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE;iCAC5G,CAAC,IAAI,CAAC,IAAI,CAAC;6BACb,CAAA;wBACH,CAAC;oBACH,CAAC;oBAED,IAAI,CAAC;wBACH,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAA;wBAC1C,OAAO;4BACL,KAAK,EAAE,gBAAgB;4BACvB,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC;yBAC3B,CAAA;oBACH,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;wBACtE,OAAO;4BACL,KAAK,EAAE,sBAAsB;4BAC7B,MAAM,EAAE,kDAAkD,OAAO,+EAA+E;yBACjJ,CAAA;oBACH,CAAC;gBACH,CAAC;aACF,CAAC;SACH;KACF,CAAA;AACH,CAAC,CAAA;AAED,eAAe,aAAa,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}

package/dist/usage.d.ts

@@ -0,0 +1,32 @@
+import type { createOpencodeClient, Message, Part } from "@opencode-ai/sdk";
+export interface ModelUsage {
+    messages: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheRead: number;
+    cacheWrite: number;
+    cost: number;
+}
+export interface ToolUsage {
+    [tool: string]: number;
+}
+export interface UsageStats {
+    totalSessions: number;
+    totalMessages: number;
+    totalCost: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalReasoningTokens: number;
+    totalCacheRead: number;
+    totalCacheWrite: number;
+    modelUsage: Record<string, ModelUsage>;
+    toolUsage: ToolUsage;
+}
+export type OpencodeClient = ReturnType<typeof createOpencodeClient>;
+export declare function aggregateMessages(messages: {
+    info: Message;
+    parts: Part[];
+}[]): UsageStats;
+export declare function aggregateUsage(client: OpencodeClient): Promise<UsageStats>;
+export declare function formatUsage(stats: UsageStats): string;
+//# sourceMappingURL=usage.d.ts.map

package/dist/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,IAAI,EAAW,MAAM,kBAAkB,CAAA;AAEpF,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACtC,SAAS,EAAE,SAAS,CAAA;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAUpE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,EAAE,GAAG,UAAU,CAyD1F;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBhF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAqDrD"}

package/dist/usage.js

@@ -0,0 +1,125 @@
+function isAssistantMessage(message) {
+    return "role" in message && message.role === "assistant";
+}
+function isToolPart(part) {
+    return part.type === "tool";
+}
+export function aggregateMessages(messages) {
+    const stats = {
+        totalSessions: 0,
+        totalMessages: messages.length,
+        totalCost: 0,
+        totalInputTokens: 0,
+        totalOutputTokens: 0,
+        totalReasoningTokens: 0,
+        totalCacheRead: 0,
+        totalCacheWrite: 0,
+        modelUsage: {},
+        toolUsage: {},
+    };
+    for (const { info, parts } of messages) {
+        if (!isAssistantMessage(info))
+            continue;
+        stats.totalCost += info.cost ?? 0;
+        const tokens = info.tokens;
+        if (tokens) {
+            stats.totalInputTokens += tokens.input ?? 0;
+            stats.totalOutputTokens += tokens.output ?? 0;
+            stats.totalReasoningTokens += tokens.reasoning ?? 0;
+            stats.totalCacheRead += tokens.cache?.read ?? 0;
+            stats.totalCacheWrite += tokens.cache?.write ?? 0;
+        }
+        const modelKey = `${info.providerID}/${info.modelID}`;
+        if (!stats.modelUsage[modelKey]) {
+            stats.modelUsage[modelKey] = {
+                messages: 0,
+                inputTokens: 0,
+                outputTokens: 0,
+                cacheRead: 0,
+                cacheWrite: 0,
+                cost: 0,
+            };
+        }
+        const model = stats.modelUsage[modelKey];
+        model.messages += 1;
+        if (tokens) {
+            model.inputTokens += tokens.input ?? 0;
+            model.outputTokens += tokens.output ?? 0;
+            model.cacheRead += tokens.cache?.read ?? 0;
+            model.cacheWrite += tokens.cache?.write ?? 0;
+        }
+        model.cost += info.cost ?? 0;
+        for (const part of parts) {
+            if (isToolPart(part)) {
+                stats.toolUsage[part.tool] = (stats.toolUsage[part.tool] ?? 0) + 1;
+            }
+        }
+    }
+    return stats;
+}
+export async function aggregateUsage(client) {
+    const sessionsResponse = await client.session.list();
+    const sessions = Array.isArray(sessionsResponse.data)
+        ? sessionsResponse.data
+        : [];
+    const allMessages = [];
+    for (const session of sessions) {
+        try {
+            const response = await client.session.messages({ path: { id: session.id } });
+            const messages = Array.isArray(response.data) ? response.data : [];
+            allMessages.push(...messages);
+        }
+        catch (error) {
+            // Skip sessions we cannot read.
+            continue;
+        }
+    }
+    const stats = aggregateMessages(allMessages);
+    stats.totalSessions = sessions.length;
+    return stats;
+}
+export function formatUsage(stats) {
+    const totalTokens = stats.totalInputTokens +
+        stats.totalOutputTokens +
+        stats.totalReasoningTokens +
+        stats.totalCacheRead +
+        stats.totalCacheWrite;
+    const lines = [
+        "## OpenCode Usage",
+        "",
+        `- Sessions: ${stats.totalSessions.toLocaleString()}`,
+        `- Messages: ${stats.totalMessages.toLocaleString()}`,
+        `- Total Cost: $${stats.totalCost.toFixed(4)}`,
+        `- Total Tokens: ${totalTokens.toLocaleString()}`,
+        `  - Input: ${stats.totalInputTokens.toLocaleString()}`,
+        `  - Output: ${stats.totalOutputTokens.toLocaleString()}`,
+        `  - Reasoning: ${stats.totalReasoningTokens.toLocaleString()}`,
+        `  - Cache Read: ${stats.totalCacheRead.toLocaleString()}`,
+        `  - Cache Write: ${stats.totalCacheWrite.toLocaleString()}`,
+        "",
+    ];
+    const models = Object.entries(stats.modelUsage).sort(([, a], [, b]) => b.messages - a.messages);
+    if (models.length > 0) {
+        lines.push("### Model Usage");
+        lines.push("");
+        for (const [model, usage] of models) {
+            lines.push(`- ${model}`);
+            lines.push(`  - Messages: ${usage.messages.toLocaleString()}`);
+            lines.push(`  - Tokens: ${(usage.inputTokens + usage.outputTokens).toLocaleString()} (in ${usage.inputTokens.toLocaleString()} / out ${usage.outputTokens.toLocaleString()})`);
+            lines.push(`  - Cost: $${usage.cost.toFixed(4)}`);
+        }
+        lines.push("");
+    }
+    const tools = Object.entries(stats.toolUsage).sort(([, a], [, b]) => b - a);
+    if (tools.length > 0) {
+        lines.push("### Tool Usage");
+        lines.push("");
+        for (const [tool, count] of tools) {
+            lines.push(`- ${tool}: ${count.toLocaleString()}`);
+        }
+        lines.push("");
+    }
+    lines.push("_Cloud plan/quota information is not available because OpenCode does not expose a public usage API yet. Set `OpenCodeUsage.enableCloudApi: true` once it is supported._");
+    return lines.join("\n");
+}
+//# sourceMappingURL=usage.js.map

package/dist/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "opencode-usage-stats",
+  "version": "0.1.0",
+  "description": "An OpenCode plugin that surfaces local usage statistics and reserves a cloud usage API integration.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "usage",
+    "ai",
+    "agent"
+  ],
+  "author": "OpenUsage",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/QianYuan1437/OpenUsage.git"
+  },
+  "bugs": {
+    "url": "https://github.com/QianYuan1437/OpenUsage/issues"
+  },
+  "homepage": "https://github.com/QianYuan1437/OpenUsage#readme",
+  "peerDependencies": {
+    "@opencode-ai/plugin": "^1.18.0",
+    "@opencode-ai/sdk": "^1.18.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.18.11",
+    "@opencode-ai/sdk": "^1.18.11",
+    "@types/node": "^26.1.2",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}