rig-opencode 0.1.1

package/README.md

@@ -0,0 +1,63 @@
+# rig-opencode
+
+OpenCode plugin that records skill usage to a local JSONL file for Rig.
+
+## Install
+
+Add the npm package to your OpenCode config.
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["rig-opencode"]
+}
+```
+
+OpenCode installs npm plugins automatically with Bun at startup.
+
+## What It Records
+
+When OpenCode executes the native `skill` tool, the plugin appends one JSON line:
+
+```json
+{"source":"opencode","skillName":"typescript-fix-null-safety","usedAt":"2026-05-30T01:12:00.000Z"}
+```
+
+Default log path:
+
+```txt
+~/.rig/usage.jsonl
+```
+
+Rig reads this file to show skill usage counts and dashboard summaries.
+
+## Environment Variables
+
+The plugin works without any environment variables. Use these only when you want
+to customize where logs are written or temporarily disable tracking.
+
+| Name | Default | Description |
+| --- | --- | --- |
+| `RIG_USAGE_LOG_PATH` | `~/.rig/usage.jsonl` | JSONL file path to append usage events to. |
+| `RIG_USAGE_SOURCE` | `opencode` | Source value written into each event. |
+| `RIG_USAGE_DISABLED` | unset | Set to `1` or `true` to disable recording. |
+
+Examples:
+
+```bash
+# Write usage logs somewhere else
+RIG_USAGE_LOG_PATH=./.rig/usage/rig-usage.jsonl opencode
+
+# Override the source field
+RIG_USAGE_SOURCE=opencode-local opencode
+
+# Temporarily disable tracking
+RIG_USAGE_DISABLED=1 opencode
+```
+
+## Local Development
+
+```bash
+pnpm --filter rig-opencode check-ts
+pnpm --filter rig-opencode build
+```

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { Plugin } from '@opencode-ai/plugin';
+
+interface RigSkillUsageLogEntry {
+    source: string;
+    skillName: string;
+    usedAt: string;
+}
+declare const RigSkillUsagePlugin: Plugin;
+
+export { type RigSkillUsageLogEntry, RigSkillUsagePlugin };

package/dist/index.js

@@ -0,0 +1,3 @@
+import{appendFile as a,mkdir as g}from"node:fs/promises";import{homedir as c}from"node:os";import{dirname as f,resolve as u}from"node:path";var k="~/.rig/usage.jsonl",p="opencode",E=async()=>({"tool.execute.after":async(n,r)=>{if(d()||!S(n))return;let e=y(n,r);e&&await m({source:process.env.RIG_USAGE_SOURCE||p,skillName:e,usedAt:new Date().toISOString()})}}),m=async n=>{let r=w(process.env.RIG_USAGE_LOG_PATH||k);await g(f(r),{recursive:!0}),await a(r,`${JSON.stringify(n)}
+`,"utf8")},d=()=>{let n=process.env.RIG_USAGE_DISABLED?.toLowerCase();return n==="1"||n==="true"},S=n=>t(n,"tool")==="skill",y=(n,r)=>{let e=[n,r,s(n,"args"),s(r,"args"),s(n,"input"),s(r,"input")];for(let o of e){let l=t(o,"skillName")??t(o,"skill_name")??t(o,"name")??t(o,"skill");if(l)return l}return null},s=(n,r)=>{if(!i(n))return null;let e=n[r];return i(e)?e:null},t=(n,r)=>{if(!i(n))return null;let e=n[r];return typeof e=="string"&&e.trim().length>0?e:null},i=n=>typeof n=="object"&&n!==null,w=n=>n==="~"?c():n.startsWith("~/")?u(c(),n.slice(2)):u(n);export{E as RigSkillUsagePlugin};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { appendFile, mkdir } from 'node:fs/promises';\nimport { homedir } from 'node:os';\nimport { dirname, resolve } from 'node:path';\nimport type { Plugin } from '@opencode-ai/plugin';\n\nconst DEFAULT_LOG_PATH = '~/.rig/usage.jsonl';\nconst DEFAULT_SOURCE = 'opencode';\n\nexport interface RigSkillUsageLogEntry {\n  source: string;\n  skillName: string;\n  usedAt: string;\n}\n\nexport const RigSkillUsagePlugin: Plugin = async () => {\n  return {\n    'tool.execute.after': async (input, output) => {\n      if (isDisabled()) {\n        return;\n      }\n\n      if (!isSkillTool(input)) {\n        return;\n      }\n\n      const skillName = getSkillName(input, output);\n\n      if (!skillName) {\n        return;\n      }\n\n      await appendUsage({\n        source: process.env.RIG_USAGE_SOURCE || DEFAULT_SOURCE,\n        skillName,\n        usedAt: new Date().toISOString(),\n      });\n    },\n  };\n};\n\nconst appendUsage = async (entry: RigSkillUsageLogEntry) => {\n  const logPath = expandPath(\n    process.env.RIG_USAGE_LOG_PATH || DEFAULT_LOG_PATH,\n  );\n\n  await mkdir(dirname(logPath), { recursive: true });\n  await appendFile(logPath, `${JSON.stringify(entry)}\\n`, 'utf8');\n};\n\nconst isDisabled = () => {\n  const value = process.env.RIG_USAGE_DISABLED?.toLowerCase();\n\n  return value === '1' || value === 'true';\n};\n\nconst isSkillTool = (input: unknown) => {\n  return getStringProperty(input, 'tool') === 'skill';\n};\n\nconst getSkillName = (input: unknown, output: unknown) => {\n  const candidates = [\n    input,\n    output,\n    getObjectProperty(input, 'args'),\n    getObjectProperty(output, 'args'),\n    getObjectProperty(input, 'input'),\n    getObjectProperty(output, 'input'),\n  ];\n\n  for (const candidate of candidates) {\n    const skillName =\n      getStringProperty(candidate, 'skillName') ??\n      getStringProperty(candidate, 'skill_name') ??\n      getStringProperty(candidate, 'name') ??\n      getStringProperty(candidate, 'skill');\n\n    if (skillName) {\n      return skillName;\n    }\n  }\n\n  return null;\n};\n\nconst getObjectProperty = (value: unknown, key: string) => {\n  if (!isRecord(value)) {\n    return null;\n  }\n\n  const property = value[key];\n\n  return isRecord(property) ? property : null;\n};\n\nconst getStringProperty = (value: unknown, key: string) => {\n  if (!isRecord(value)) {\n    return null;\n  }\n\n  const property = value[key];\n\n  return typeof property === 'string' && property.trim().length > 0\n    ? property\n    : null;\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => {\n  return typeof value === 'object' && value !== null;\n};\n\nconst expandPath = (path: string) => {\n  if (path === '~') {\n    return homedir();\n  }\n\n  if (path.startsWith('~/')) {\n    return resolve(homedir(), path.slice(2));\n  }\n\n  return resolve(path);\n};\n"],"mappings":"AAAA,OAAS,cAAAA,EAAY,SAAAC,MAAa,mBAClC,OAAS,WAAAC,MAAe,UACxB,OAAS,WAAAC,EAAS,WAAAC,MAAe,YAGjC,IAAMC,EAAmB,qBACnBC,EAAiB,WAQVC,EAA8B,UAClC,CACL,qBAAsB,MAAOC,EAAOC,IAAW,CAK7C,GAJIC,EAAW,GAIX,CAACC,EAAYH,CAAK,EACpB,OAGF,IAAMI,EAAYC,EAAaL,EAAOC,CAAM,EAEvCG,GAIL,MAAME,EAAY,CAChB,OAAQ,QAAQ,IAAI,kBAAoBR,EACxC,UAAAM,EACA,OAAQ,IAAI,KAAK,EAAE,YAAY,CACjC,CAAC,CACH,CACF,GAGIE,EAAc,MAAOC,GAAiC,CAC1D,IAAMC,EAAUC,EACd,QAAQ,IAAI,oBAAsBZ,CACpC,EAEA,MAAMJ,EAAME,EAAQa,CAAO,EAAG,CAAE,UAAW,EAAK,CAAC,EACjD,MAAMhB,EAAWgB,EAAS,GAAG,KAAK,UAAUD,CAAK,CAAC;AAAA,EAAM,MAAM,CAChE,EAEML,EAAa,IAAM,CACvB,IAAMQ,EAAQ,QAAQ,IAAI,oBAAoB,YAAY,EAE1D,OAAOA,IAAU,KAAOA,IAAU,MACpC,EAEMP,EAAeH,GACZW,EAAkBX,EAAO,MAAM,IAAM,QAGxCK,EAAe,CAACL,EAAgBC,IAAoB,CACxD,IAAMW,EAAa,CACjBZ,EACAC,EACAY,EAAkBb,EAAO,MAAM,EAC/Ba,EAAkBZ,EAAQ,MAAM,EAChCY,EAAkBb,EAAO,OAAO,EAChCa,EAAkBZ,EAAQ,OAAO,CACnC,EAEA,QAAWa,KAAaF,EAAY,CAClC,IAAMR,EACJO,EAAkBG,EAAW,WAAW,GACxCH,EAAkBG,EAAW,YAAY,GACzCH,EAAkBG,EAAW,MAAM,GACnCH,EAAkBG,EAAW,OAAO,EAEtC,GAAIV,EACF,OAAOA,CAEX,CAEA,OAAO,IACT,EAEMS,EAAoB,CAACH,EAAgBK,IAAgB,CACzD,GAAI,CAACC,EAASN,CAAK,EACjB,OAAO,KAGT,IAAMO,EAAWP,EAAMK,CAAG,EAE1B,OAAOC,EAASC,CAAQ,EAAIA,EAAW,IACzC,EAEMN,EAAoB,CAACD,EAAgBK,IAAgB,CACzD,GAAI,CAACC,EAASN,CAAK,EACjB,OAAO,KAGT,IAAMO,EAAWP,EAAMK,CAAG,EAE1B,OAAO,OAAOE,GAAa,UAAYA,EAAS,KAAK,EAAE,OAAS,EAC5DA,EACA,IACN,EAEMD,EAAYN,GACT,OAAOA,GAAU,UAAYA,IAAU,KAG1CD,EAAcS,GACdA,IAAS,IACJxB,EAAQ,EAGbwB,EAAK,WAAW,IAAI,EACftB,EAAQF,EAAQ,EAAGwB,EAAK,MAAM,CAAC,CAAC,EAGlCtB,EAAQsB,CAAI","names":["appendFile","mkdir","homedir","dirname","resolve","DEFAULT_LOG_PATH","DEFAULT_SOURCE","RigSkillUsagePlugin","input","output","isDisabled","isSkillTool","skillName","getSkillName","appendUsage","entry","logPath","expandPath","value","getStringProperty","candidates","getObjectProperty","candidate","key","isRecord","property","path"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "rig-opencode",
+  "version": "0.1.1",
+  "private": false,
+  "description": "OpenCode plugin for tracking Rig skill usage locally",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsup",
+    "check-ts": "tsc --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "rig",
+    "skills",
+    "usage-tracking"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.15.13",
+    "@types/node": "catalog:types",
+    "tsup": "catalog:build",
+    "typescript": "catalog:types"
+  }
+}