letmecode 0.1.22 → 0.1.23

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Devforth
+
+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

@@ -1,32 +1,51 @@
-# letmecode - Discover your detailed agent ussage Codex | Claude
+# LetMeCode
 
-Ussage:
+Terminal AI real-money value usage dashboard for Codex, Claude, Copilot, and Antigravity.
+
+See your real $ usage data, inspect limits, see daily activity, and model-level token totals in a terminal UI.
+
+## Quick start
 
 ```bash
 npx -y letmecode@latest
 ```
 
+## Privacy and anonymous reporting
 
-Preview:
-
-<img width="2301" height="1397" alt="image" src="https://github.com/user-attachments/assets/c37d6847-9926-4977-8592-5cab8346a86f" />
+By default, `letmecode` sends an anonymous usage summary which powers [aggregated real-world plans comparison](https://devforth.io/agents-for-code/).
 
+The report includes aggregated limit-window percentages, token counts, plan/window metadata, the `letmecode` version, and a hashed user identifier when a provider exposes one. It does not send prompt content, usernames, email addresses, company names, or other directly identifiable personal information.
 
+To disable anonymous usage reporting:
 
+```bash
+npx -y letmecode@latest -- --no-usage
+```
 
-## Advanced ussage
+## Options
 
+```bash
+npx -y letmecode@latest -- --help
+npx -y letmecode@latest -- --log-to ./letmecode.log
 ```
-npx -y letmecode -- -h
-npx -y letmecode -- --log-to log.txt
-```
 
-`--log-to` now records Claude binary discovery, session-root selection, parsed transcript file summaries, entrypoint matching, raw `/usage` output, and live-window event matching so zero-token windows are diagnosable.
+`--log-to` records provider discovery details and raw usage parsing diagnostics so empty or unexpected windows are easier to debug.
+
+## Providers
+
+- Codex
+- Claude
+- Copilot
+- Antigravity
+
+## Preview
 
+<img width="2301" height="1397" alt="letmecode preview" src="https://github.com/user-attachments/assets/c37d6847-9926-4977-8592-5cab8346a86f" />
 
 ## Local development
 
 ```bash
 pnpm install
+pnpm test
 pnpm start
 ```

package/ink-app/dist/cli-options.js

@@ -4,6 +4,7 @@ export function parseCliOptions(argv) {
     let showHelp = false;
     let verbose = false;
     let logToPath;
+    let enableAnonymousUsageReporting = true;
     for (let index = 0; index < argv.length; index += 1) {
         const argument = argv[index] ?? "";
         if (argument === "-h" || argument === "--help") {
@@ -29,9 +30,13 @@ export function parseCliOptions(argv) {
                 throw new Error("Expected a file path after --log-to=.");
             }
             logToPath = value;
+            continue;
+        }
+        if (argument === "--no-usage") {
+            enableAnonymousUsageReporting = false;
         }
     }
-    return { showHelp, verbose, logToPath };
+    return { showHelp, verbose, logToPath, enableAnonymousUsageReporting };
 }
 export function buildProviderStatsOptions(options) {
     return {
@@ -41,7 +46,7 @@ export function buildProviderStatsOptions(options) {
 }
 export function buildHelpText() {
     return [
-        "letmecode - provider-based terminal usage dashboard",
+        "letmecode - terminal AI usage dashboard",
         "",
         "Usage:",
         "  letmecode [options]",
@@ -50,6 +55,7 @@ export function buildHelpText() {
         "  -h, --help         Show this help and exit",
         "  -v, --verbose      Show extra provider warnings",
         "  --log-to PATH      Write trace logs to PATH",
+        "  --no-usage         Disable anonymous usage reporting",
         "",
         "Controls:",
         "  [ ] / Tab          Switch providers",
@@ -64,7 +70,11 @@ export function buildHelpText() {
         "  --log-to PATH writes Claude detection details,",
         "  session root selection, parsed session file summaries, aggregated usage selection,",
         "  every candidate binary path check, the final found/not-found result,",
-        "  and the raw /usage command output plus live window matching details."
+        "  and the raw /usage command output plus live window matching details.",
+        "",
+        "Anonymous reporting:",
+        "  Enabled by default. Use --no-usage to disable the best-effort",
+        "  anonymous usage summary upload."
     ].join("\n");
 }
 export function createFileTraceLogger(logPath) {

package/ink-app/dist/index.js

@@ -96,7 +96,9 @@ function App(props) {
         setSelectedProviderId(topProvider.provider.id);
     }, [hasUserSelectedProvider, providerStates, sortedProviderStates]);
     useEffect(() => {
-        if (hasReportedAnonymousUsageRef.current || providerStates.some((state) => state.status === "loading")) {
+        if (!props.usageReportingEnabled ||
+            hasReportedAnonymousUsageRef.current ||
+            providerStates.some((state) => state.status === "loading")) {
             return;
         }
         hasReportedAnonymousUsageRef.current = true;
@@ -106,7 +108,7 @@ function App(props) {
         void reportAnonymousUsage(readyStats).catch(() => {
             // Anonymous usage reporting is best-effort and must never disturb the TUI.
         });
-    }, [providerStates]);
+    }, [props.usageReportingEnabled, providerStates]);
     useMouseClick((click) => {
         const regionId = resolveClick(click);
         if (!regionId) {
@@ -1002,7 +1004,7 @@ export function main(argv = process.argv.slice(2)) {
         restoreFullscreen();
     };
     process.once("exit", exitHandler);
-    const instance = render(_jsx(App, { statsOptions: statsOptions }), {
+    const instance = render(_jsx(App, { statsOptions: statsOptions, usageReportingEnabled: cliOptions.enableAnonymousUsageReporting }), {
         stdout: process.stdout,
         stdin: process.stdin,
         stderr: process.stderr

package/package.json

@@ -1,13 +1,23 @@
 {
   "name": "letmecode",
-  "version": "0.1.22",
-  "description": "Provider-based terminal usage dashboard for LetMeCode.",
-  "author": "devforth.io",
+  "version": "0.1.23",
+  "description": "Terminal AI usage dashboard for Codex, Claude, Copilot, and Antigravity.",
+  "author": "Devforth (https://devforth.io)",
   "license": "MIT",
+  "packageManager": "pnpm@10.28.2",
   "type": "commonjs",
+  "main": "./dist/index.js",
   "bin": {
     "letmecode": "./bin/letmecode.js"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devforth/letmecode.git"
+  },
+  "homepage": "https://github.com/devforth/letmecode#readme",
+  "bugs": {
+    "url": "https://github.com/devforth/letmecode/issues"
+  },
   "files": [
     "bin",
     "dist",
@@ -20,10 +30,29 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true }); require('node:fs').rmSync('ink-app/dist', { recursive: true, force: true });\"",
+    "build": "npm run clean && tsc -p tsconfig.json && tsc -p ink-app/tsconfig.json",
+    "prepack": "npm run build",
+    "prestart": "npm run build",
+    "start": "node ./bin/letmecode.js",
+    "pretest": "npm run build",
+    "smoke": "node ./bin/letmecode.js",
+    "test": "node --test ink-app/test/*.test.mjs"
+  },
   "keywords": [
+    "ai",
+    "agents",
     "cli",
-    "ink",
+    "dashboard",
+    "usage",
+    "terminal",
+    "codex",
+    "claude",
+    "copilot",
+    "antigravity",
     "npx",
+    "ink",
     "typescript"
   ],
   "dependencies": {
@@ -35,14 +64,5 @@
     "@types/node": "^24.0.7",
     "@types/react": "^18.3.24",
     "typescript": "^5.8.3"
-  },
-  "scripts": {
-    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true }); require('node:fs').rmSync('ink-app/dist', { recursive: true, force: true });\"",
-    "build": "npm run clean && tsc -p tsconfig.json && tsc -p ink-app/tsconfig.json",
-    "prestart": "npm run build",
-    "start": "node ./bin/letmecode.js",
-    "pretest": "npm run build",
-    "smoke": "node ./bin/letmecode.js",
-    "test": "node --test ink-app/test/*.test.mjs"
   }
-}
+}