Repository navigation
Toolshed v0.1.0
First public release.
An adaptive tool-surface proxy for Hermes — reduces repeated tool-schema overhead while preserving on-demand recovery.
Highlights
- Session-sticky tool-surface routing (deterministic + optional LLM classifier)
- Floor toolsets: critical capabilities are never pruned
- Dynamic MCP routing: any configured MCP server becomes routable automatically
- Monotonic recovery via
request_toolset(fail-open) - Profile-scoped state: multi-agent safe
- Explicit authorization: requires
--allow-tool-overridegrant; fail-closed without it
Measured
- ~31% input-token reduction on a fresh Hermes setup (identical tasks, ON vs OFF)
- 32–70% in earlier controlled paired workloads
- Results vary with tool count and workload — see docs/benchmarks for methodology
Install
hermes plugins install Huy3ko/toolshed
hermes plugins enable hermes-token-router --allow-tool-overrideThen set global.enabled: true in the plugin's config.yaml. See README for the full guide.
Known limitations
- Gateway-restart/learning persistence not yet validated in systemd-user environments
- Validated against Hermes upstream b766607b