Opencode The Token Company Plugin

OpenCode message transform plugin with The Token Company (TTC) API.

The Token Company (YC W26) builds models that process tokens based on context and semantic intent. With this plugin, you can remove context bloat from your prompts to Opencode before they hit the LLM provider.

1) Setup

Option A: Let an LLM do it

Paste this into your coding agent:

Install the @drfok/opencode-ttc-plugin and install the plugin by following: https://raw.githubusercontent.com/MrFok/opencode-ttc-plugin/main/README.md

Option B: Manual setup

1. Install and register plugin:

npm install -g @drfok/opencode-ttc-plugin
opencode-ttc-plugin install

3. Configure auth in OpenCode:

opencode auth login

3. In the auth flow choose:

• provider: the-token-company-plugin
• method: Set TTC API Key
• paste key from https://thetokencompany.com/

4. Verify:

opencode-ttc-plugin doctor --verbose

For LLMs

1. Install @drfok/opencode-ttc-plugin with npm '''bash npm install -g @drfok/opencode-ttc-plugin '''

2. Run the installation command to place the js file into the /.config/opencode/plugins directory '''bash opencode-ttc-plugin install '''

Finally, tell the user to

1. Run opencode auth login

2. Search for the-token-company-plugin

3. Enter their TTC API key (obtain from https://thetokencompany.com/)

4. Verify by running opencode-ttc-plugin doctor --verbose

5. Tell them to restart their OpenCode, and to watch for the toast when they start a session

2) Configure compression aggressiveness

Primary control is aggressiveness. You can set it by named level (recommended) or exact numeric value.

Set by level:

opencode-ttc-plugin config set level balanced

Set exact value:

opencode-ttc-plugin config set aggressiveness 0.25

Inspect active config:

opencode-ttc-plugin config get
opencode-ttc-plugin doctor --verbose

Compression levels:

Level	Aggressiveness	Typical tradeoff
low	0.05	Minimal changes, conservative compression
balanced	0.10	Default; good savings with stable quality
high	0.20	Stronger compression, better token reduction
max	0.30	Most aggressive preset in this plugin

Why these values exist:

• TTC API exposes aggressiveness on a 0.0-1.0 range in their docs: https://thetokencompany.com/docs
• TTC benchmark data shows quality/token tradeoffs vary by aggressiveness: https://www.thetokencompany.com/benchmarks/accuracy

Runtime resolution order for aggressiveness:

1. TTC_AGGRESSIVENESS env var (override)
2. plugin config file ~/.config/opencode/ttc-plugin.json
3. built-in default (balanced = 0.1)

3) CLI commands

Command	What it does
opencode-ttc-plugin install	Installs plugin file into ~/.config/opencode/plugins
opencode-ttc-plugin doctor	Runs setup/auth checks
opencode-ttc-plugin doctor --verbose	Shows effective config sources and resolution order
opencode-ttc-plugin uninstall	Removes installed plugin file
opencode-ttc-plugin config get	Prints plugin config and effective aggressiveness
opencode-ttc-plugin config set level <low|balanced|high|max>	Sets named aggressiveness level
opencode-ttc-plugin config set aggressiveness <0..1>	Sets numeric aggressiveness
opencode-ttc-plugin config set <setting> <value>	Sets behavior settings (see table below)
opencode-ttc-plugin config reset	Removes plugin config file

Behavior settings

Use CLI config for normal setup. Env vars are advanced overrides.

Setting	Default	What it does	CLI command
enabled	true	Master on/off switch for the transform hook	opencode-ttc-plugin config set enabled true
model	bear-1.2	TTC model sent to /v1/compress	opencode-ttc-plugin config set model bear-1.2
minChars	400	Skip compression for text shorter than this	opencode-ttc-plugin config set min-chars 400
timeoutMs	2000	Request timeout per TTC call	opencode-ttc-plugin config set timeout-ms 2000
maxRetries	1	Retry count for retryable TTC failures	opencode-ttc-plugin config set max-retries 1
retryBackoffMs	100	Backoff base between retries	opencode-ttc-plugin config set retry-backoff-ms 100
useGzip	true	Sends compressed request body to TTC	opencode-ttc-plugin config set use-gzip true
compressSystem	false	Also compresses eligible system messages in context	opencode-ttc-plugin config set compress-system false
compressHistory	false	Also compresses older eligible user history messages (not just latest user turn)	opencode-ttc-plugin config set compress-history false
debug	false	Emits extra plugin debug logs	opencode-ttc-plugin config set debug false
cacheMaxEntries	1000	Max in-memory dedupe cache entries	opencode-ttc-plugin config set cache-max-entries 1000
toastOnActive	true	Shows one activation toast per session	opencode-ttc-plugin config set toast-on-active true
toastOnIdleSummary	true	Shows idle summary toast with savings stats	opencode-ttc-plugin config set toast-on-idle-summary true

Notes on scope:

• TTC API parameters used directly by this plugin request are primarily model and compression_settings.aggressiveness.
• Most settings above are plugin-side controls (selection, retries, skipping, caching, and UX behavior).
• For TTC API details, see https://thetokencompany.com/docs.

Advanced overrides (optional):

• TTC_AGGRESSIVENESS, TTC_MIN_CHARS, TTC_TIMEOUT_MS, TTC_MAX_RETRIES, TTC_RETRY_BACKOFF_MS
• TTC_USE_GZIP, TTC_COMPRESS_SYSTEM, TTC_COMPRESS_HISTORY, TTC_DEBUG
• TTC_CACHE_MAX_ENTRIES, TTC_TOAST_ON_ACTIVE, TTC_TOAST_ON_IDLE_SUMMARY, TTC_MODEL, TTC_ENABLED

Security and network policy

• Compression egress is pinned to https://api.thetokencompany.com.
• Custom/invalid TTC_BASE_URL is ignored and safely falls back to pinned host.
• If your firewall prompts about outbound socket traffic, that is expected on first compression request.