Skip to content

OpenCode

The package default export provides setup (OpenCode 2 context hook and MCP self-registration) and server (OpenCode 1 headers and /compact).

OpenCode 2 (opencode >= 2.2):

Terminal window
opencode plugin add smarter-compact # npm package (recommended)
opencode plugin add <user>/smarter-compact # Git shorthand
opencode plugin list # installed package plugins

Both write "plugins": ["<spec>"] to the global config and install the package under the OpenCode npm cache.

From a local clone, plugin add accepts only npm/Git specs; point the config at the checkout instead:

{ "plugins": ["/absolute/path/to/smarter-compact"] }

Keep the clone in place; OpenCode resolves the package from it.

The plugin registers its context hooks by itself, and attempts to register its search MCP tools the same way (ctx.mcp.add, OpenCode >= 2.2). OpenCode can accept that call and still connect no server, so write the mcp entry below as well and rely on it. Registering twice is harmless. Options are the same keys as CONTEXT_* env vars (camelCase in JSON):

opencode.json
{
"plugins": [
{
"package": "smarter-compact",
"options": {
"trimAtTokens": 125000,
"compressOverTokens": 4000
}
}
]
}

OpenCode 2 trims inside the plugin. You do not run smarter-compact enable opencode or point provider.anthropic.options.baseURL at the proxy.

Commands:

  • /compact — trim on the next request (registered by the plugin).
  • MCP tools smart_compact_search, smart_compact_sql, smart_compact_get, context_status (needs node >= 24 on PATH). Configure them explicitly — the plugin’s own ctx.mcp.add is best effort:
// opencode.json — same store the plugin trims into, so $SMARTER_COMPACT_STATE_DIR must match
{
"mcp": {
"servers": {
"smarter-compact": {
"type": "local",
"command": ["node", "/path/to/smarter-compact/plugin/lib/mcp/server.mjs"],
"environment": { "SMARTER_COMPACT_STATE_DIR": "/var/lib/smarter-compact" },
"enabled": true
}
}
}
}

Verify rather than assume: the plugin prints one smarter-compact: recall MCP registered (or NOT registered reason=…) line to stderr at startup, and every answered call appends a line to $SMARTER_COMPACT_STATE_DIR/context/tool-calls.jsonl. OpenCode exposes an MCP tool as <server>_<tool> — smarter-compact_smart_compact_search, underscore, seen verbatim in captured requests — so the pointer and standing instruction name that qualified form, never the bare one.

The scratchpad is on by default, and the nudge names smarter-compact_smart_compact_scratchpad. To turn it off, set CONTEXT_SCRATCHPAD=0 in the server’s environment too; the self-registration forwards it from the plugin’s environment. When a server is left behind code mode the tools are reachable only through that runner’s execute input, so counting top-level tool names alone under-reads recall to zero; the bench therefore sets "codemode": false on this server.

OpenCode 1 has no context hook, so trimming goes through the LiteLLM proxy:

Terminal window
./plugin/scripts/smarter-compact enable opencode

enable starts the proxy in the background (CONTEXT_PROXY_PORT, default 4101).

The proxy reads its own environment, so set CONTEXT_* variables or proxy.env; of the OpenCode 1 plugin options only stateDir applies, to session registration and /compact flags (reference).

The server hook sends x-smarter-compact-session-id when your Anthropic baseURL is the local proxy, registers the session, and honours /compact.

Each option maps to a CONTEXT_* variable; which ones OpenCode 2 honours: configuration reference.

Store layout: context-store.md.