# NousResearch/hermes-agent · Tool and toolset enable/disable filtering controls

## Open now

- 2 issues, 3 PRs open on GitHub.
- #31375: Feature: Per-tool enable/disable in config (below toolset granularity)
- #42585: \[Bug\]: web_search remains exposed via browser when the web toolset is disabled
- PR #69675: feat: per-function tool filtering via tools.disabled_functions config
- PR #110774: feat(tools): tools.disabled_functions removes single tools everywhere (salvage #69675)
- PR #113678: feat(cli): --disable-tools and tools.disabled_functions remove single tools below toolset granularity (salvage #110774, #69675)

These issues and PRs concern configuring which tools and toolsets are active, including per-function disabling, per-platform filtering, and bugs around shared tools (especially web_search) being incorrectly removed or exposed when a toolset is disabled.

## TL;DR

- 12 member(s): 2 open issue(s), 2 closed issue(s), 3 open PR(s), 1 merged PR(s), 4 PR(s) closed without merging.
- A fix was merged to main in PR #103463. Verify it addresses your case.
- **Recommended:** read PR #103463 (and any competing PRs below) before filing. Confirm the merged change covers your symptom.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `partially_resolved` · deciding PR(s): `pr-103463`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_PARTIAL`): some members are connected by structural evidence (shared changed files, or a closing/superseded reference); the rest are joined by an automated relevance judgement over their text.
- Members outside that structural core may belong to a different underlying problem.
- Pairwise link density `0.15`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Open related issues

- #31375: Feature: Per-tool enable/disable in config (below toolset granularity)
- #42585: \[Bug\]: web_search remains exposed via browser when the web toolset is disabled

## Closed / duplicate issues

- #52597: \[Feature\]: Disable toolset per messenger platform?
- #64503: disabled_toolsets: \[browser\] silently removes web_search from every session (browser toolset statically includes web_search)

## Prior & competing PRs

- **#64734: fix(tools): don't strip shared tools when disabling a toolset (#64503)**. closed without merge · fix tier `suggested`
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#64946`, `#64946`, `#64946`, `#64946`
  - _suggested-tier fix detail withheld; re-request with `?tier=all` to include it._
- **#103463: fix(toolsets): stop disabled browser from stripping web_search**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`; implication `superseded`
  - files: `tests/test_model_tools.py`, `tests/test_toolset_distributions.py`, `toolset_distributions.py`, `toolsets.py`
- **#42589: fix(tools): remove web_search from browser toolset to respect web disable**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `decacbac35`, `#64503`
- **#64525: fix(toolsets): stop disabled browser from stripping web_search**. closed without merge
  - maintainer direction: category `merged_via`; implication `superseded`; refs `ec1e6d50bc`, `#103463`, `#102923`, `#64503`, `#73692`
- **#64946: fix(toolsets): remove web_search from browser toolset (#64503)**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`
- **#69675: feat: per-function tool filtering via tools.disabled_functions config**. open
  - maintainer direction: category `partial_fix`; implication `needs_llm`; refs `8f08fb21f216`, `#31375`, `#68964`, `#69675`, `#69675`, `#69675`, `#69675`, `#68964`, `#31375`, `#374151`, `#31375`, `#68964`, `#69675`
  - files: `agent/agent_init.py`, `agent/tool_executor.py`, `cli.py`, `cron/scheduler.py`, `gateway/platforms/api_server.py`, `gateway/run.py`, `hermes_cli/cli_agent_setup_mixin.py`, `model_tools.py`, `tests/test_model_tools.py`
- **#110774: feat(tools): tools.disabled_functions removes single tools everywhere (salvage #69675)**. open
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#113678`, `#110774`
  - files: `agent/agent_init.py`, `agent/memory_manager.py`, `cli-config.yaml.example`, `gateway/run.py`, `model_tools.py`, `tests/test_model_tools_disabled_functions.py`, `website/docs/user-guide/configuration.md`
- **#113678: feat(cli): --disable-tools and tools.disabled_functions remove single tools below toolset granularity (salvage #110774, #69675)**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`; refs `b94a4824978fc4b558962cdf0ba2675d422ebb14`
  - files: `agent/agent_init.py`, `agent/memory_manager.py`, `cli-config.yaml.example`, `contributors/emails/[redacted:email]`, `gateway/run.py`, `hermes_cli/_parser.py`, `hermes_cli/main.py`, `hermes_cli/update_cmd_windows.py`, `model_tools.py`, `tests/test_model_tools_disabled_functions.py`, `website/docs/reference/cli-commands.md`, `website/docs/user-guide/cli.md`, `website/docs/user-guide/configuration.md`

## Fix status

- Merged to main in PR #103463 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-09-05`.
- Subsystem: `agent`