ocinsights

opencode plugin that automatically syncs every session to your ocinsights dashboard — track tokens, tools, MCP usage, and cost across all your AI sessions.

Install

npm i -g ocinsights
ocinsights setup

You'll be asked for two things:

1. Insights API URL — where your ocinsights frontend is running (default http://localhost:3001).
2. API key — get it from the ocinsights dashboard (Settings → API key).

The CLI then:

• copies the plugin to .opencode/plugins/ocinsights.js
• writes OC_INSIGHTS_API_KEY and OC_INSIGHTS_API_BASE to .env

Restart opencode and you're done — every session is synced on session.idle.

Non-interactive mode

ocinsights setup --api-key=oc_xxx --api-base=http://localhost:3001

Other commands

ocinsights import   # batch import existing sessions from running opencode server
ocinsights help

Manual install (without the CLI)

If you prefer to wire it up by hand:

1. Install the package as a dev dependency:

   npm i -D ocinsights

2. Add it to your opencode.json:

   {
     "plugin": ["ocinsights"]
   }

3. Add to .env:

   OC_INSIGHTS_API_KEY=oc_xxx
   OC_INSIGHTS_API_BASE=http://localhost:3001

4. Restart opencode.

How it works

When a session goes idle, the plugin:

1. reads all messages + tool calls from opencode
2. aggregates tokens (input, output, cache read/write, reasoning)
3. POSTs the session to {OC_INSIGHTS_API_BASE}/api/sync

Your dashboard then shows the session with full token breakdown, tool usage, MCP servers, and cost.

Local development

git clone https://github.com/anomalyco/opencode-ai-insights
cd opencode-ai-insights
npm install
npm run build

The plugin will be at dist/index.js. To test locally without publishing, copy it into your project's .opencode/plugins/ and restart opencode.

License

MIT