Add VSIX packaging and install docs

Author: DongHyunnn

.gitignore

@@ -1,2 +1,3 @@
 node_modules/
 .vscode-test/
+*.vsix

.vscodeignore

@@ -0,0 +1,8 @@
+.gitignore
+.sisyphus/
+.vscode/
+node_modules/
+scripts/
+test/
+*.vsix
+package-lock.json

LICENSE

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

README.md

@@ -20,13 +20,67 @@ A VS Code/Cursor extension that combines two sources of truth:
 
 ## Installation
 
-- Install the extension in VS Code or Cursor by opening this folder and launching the Extension Development Host.
-- For a packaged install, build a VSIX with the standard VS Code extension workflow and install that VSIX in VS Code or Cursor.
+- Install from the marketplace when it is published there, or install a GitHub release VSIX directly.
+- For local development, open this folder in VS Code or Cursor and launch the Extension Development Host.
 - Local history works immediately as long as `sqlite3` is available on `PATH`.
 - To install the companion token-tracking plugin, run `OpenCode Token Usage: Install Tracking Plugin` from the command palette or the dashboard title actions.
 - The command copies `opencode-token-usage-tracker.js` into `~/.config/opencode/plugins/`.
 - Restart OpenCode after installation so the tracker plugin is loaded.
 
+### GitHub / VSIX install
+
+Build a VSIX locally:
+
+```bash
+npm install
+npm run package:vsix
+```
+
+Install the generated VSIX in VS Code:
+
+```bash
+code --install-extension ./opencode-token-usage-extension-2.0.0.vsix
+```
+
+If the `cursor` shell command is available on your machine, you can use the same VSIX from Cursor:
+
+```bash
+cursor --install-extension ./opencode-token-usage-extension-2.0.0.vsix
+```
+
+Convenience scripts are included:
+
+```bash
+npm run install:vsix:vscode:dry-run
+npm run install:vsix:cursor:dry-run
+```
+
+Then run the real install command after packaging:
+
+```bash
+npm run install:vsix:vscode
+```
+
+or
+
+```bash
+npm run install:vsix:cursor
+```
+
+### Marketplace install
+
+Once the extension is published, install it from the VS Code extensions view by searching for `OpenCode Token Usage`, or from the CLI with:
+
+```bash
+code --install-extension donghyunnn.opencode-token-usage-extension
+```
+
+Cursor officially supports extension installation from the Extensions UI. If the `cursor` shell command is available and the same extension id is resolvable there, the equivalent command is:
+
+```bash
+cursor --install-extension donghyunnn.opencode-token-usage-extension
+```
+
 ## How it works
 
 - OpenCode history is read from the local SQLite `message` table, which already stores provider, model, token, cost, and timestamp metadata.

package.json

@@ -5,6 +5,14 @@
   "version": "2.0.0",
   "publisher": "donghyunnn",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DongHyunnn/opencode-plugin-token-usage.git"
+  },
+  "homepage": "https://github.com/DongHyunnn/opencode-plugin-token-usage",
+  "bugs": {
+    "url": "https://github.com/DongHyunnn/opencode-plugin-token-usage/issues"
+  },
   "engines": {
     "vscode": "^1.96.0"
   },
@@ -134,6 +142,11 @@
   },
   "scripts": {
     "dev": "node ./scripts/dev.js",
-    "test": "node --test"
+    "test": "node --test",
+    "package:vsix": "npx @vscode/vsce package",
+    "install:vsix:vscode": "node ./scripts/install-vsix.js code",
+    "install:vsix:cursor": "node ./scripts/install-vsix.js cursor",
+    "install:vsix:vscode:dry-run": "node ./scripts/install-vsix.js code --dry-run",
+    "install:vsix:cursor:dry-run": "node ./scripts/install-vsix.js cursor --dry-run"
   }
 }

scripts/install-vsix.js

@@ -0,0 +1,43 @@
+const fs = require("node:fs");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+function main() {
+  const editor = process.argv[2];
+  const dryRun = process.argv.includes("--dry-run");
+
+  if (!editor || !["code", "cursor"].includes(editor)) {
+    throw new Error("Usage: node scripts/install-vsix.js <code|cursor> [--dry-run]");
+  }
+
+  const root = path.resolve(__dirname, "..");
+  const manifest = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
+  const vsixName = `${manifest.name}-${manifest.version}.vsix`;
+  const vsixPath = path.join(root, vsixName);
+
+  if (!fs.existsSync(vsixPath)) {
+    throw new Error(`VSIX not found: ${vsixPath}. Run npm run package:vsix first.`);
+  }
+
+  const command = [editor, "--install-extension", vsixPath];
+  if (dryRun) {
+    console.log(command.join(" "));
+    return;
+  }
+
+  const result = spawnSync(editor, ["--install-extension", vsixPath], {
+    cwd: root,
+    stdio: "inherit",
+  });
+
+  if (result.status !== 0) {
+    throw new Error(`${editor} --install-extension failed with exit code ${result.status}`);
+  }
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+}