[DOCS] Inconsistent tool naming: KillBash vs KillShell

Documentation Type

unclear/confusing documentation

Documentation Location

https://platform.claude.com/docs/en/agent-sdk/python and https://code.claude.com/docs/en/settings

Section/Topic

Tool naming across SDK and Settings documentation

Current Documentation

Python SDK (Tool Input/Output Types):

Tool name: KillBash

TypeScript SDK:

• Tool name: KillBash
• Interface name: KillShellInput

Settings documentation (Tools available to Claude):

KillShell - Kills a running background bash shell...

What's Wrong or Missing?

The tool for killing background shells has inconsistent naming:

• SDKs call it KillBash
• Settings documentation calls it KillShell
• TypeScript SDK has a mismatch between the tool name (KillBash) and its interface (KillShellInput)

This will cause errors when developers try to:

1. Reference the tool in permission rules using the wrong name
2. Configure tool permissions in hooks
3. Filter or intercept tool calls by name

Suggested Improvement

Standardize the tool name across all documentation:

1. If KillShell is the canonical name, update SDK docs to use KillShell
2. If KillBash is the canonical name, update Settings docs to use KillBash
3. Ensure TypeScript interface names align with tool names (e.g., KillBashInput or KillShellInput consistently)

Impact

Medium - Makes feature difficult to understand

Additional Context

• None