diff --git a/README.md b/README.md index cfd8e14..8c0a281 100644 --- a/README.md +++ b/README.md @@ -176,6 +176,13 @@ The plugin exposes these tools to your OpenCode agent: - ✅ Pressure-aware compression - ✅ Zero configuration, works immediately +## Does working-memory system increase token usage? It depends. + +- **If you use the DCP plugin and regularly start new sessions:** this plugin can add some overhead, because each new session starts fresh and the memory system setup may not pay off before the session ends. +- **If you stay in one long-running session and often hit token limits/auto-compaction:** this plugin is a strong fit, because repeated compaction can make the agent forget goals, active folders, and where critical files are. + +The plugin solves this by preserving high-value memory (goal/progress/context + working memory signals) so your agent can inherit context from its "previous self" with minimal token cost, reducing repeated mistakes and the extra tokens those mistakes consume. + ## Configuration (Optional) The plugin works great with zero configuration. To customize behavior, modify the constants at the top of `index.ts`. See the [Configuration Guide](docs/configuration.md) for all tunable options.