kdeps-tools-bash_exec
v1.1.0Execute a bash shell command and return its output. Use for running scripts, checking system state (git status, ls, etc.), or performing file operations. Press Ctrl+C to interrupt (partial output returned to LLM); press Ctrl+Z to background (use bash_job_wait to retrieve output).
set tools / shelf tools
LLM context: ~159 tokens when loaded (prompt or tool definition)
Where it runs
Part of the tools set, used in workflow and agent mode. What the model is told about each built-in tool: its description, usage notes and parameters. kdeps runs the tool itself.
- the agent loop builds the request
- the tool definitions are sent to the modeltools/bash_exec
- the model calls a tool
- kdeps runs it
- the result goes back to the model
Loaded by: kdeps (agent loop), /update, /settings, kdeps run, kdeps install, kdeps list, kdeps uninstall, kdeps update
In the code: kdeps (agent loop)agent.RegisterBuiltinToolsagent.definedAs
Install
A kdeps asset: installed with the first-run profile that includes its set, or the first time a command needs it, and updated without a new release.
Pin a version with kdeps install tools/bash_exec@<version>.
Contents
Execute a bash shell command and return its output. Use for running scripts, checking system state (git status, ls, etc.), or performing file operations. Press Ctrl+C to interrupt (partial output returned to LLM); press Ctrl+Z to background (use bash_job_wait to retrieve output).
- category
- shell
- outputFormat
- plain text (stdout + optional stderr), truncated to 2000 lines
- seeAlso
- read_file, search_local, edit_file, write_file
| Parameter | Type | Description |
|---|---|---|
| command * | string | The bash command to execute |
aliases:
- bash
- shell
- sh
- terminal
- run_command
- execute_command
- run_terminal_cmd
- run_shell_command
- exec_command
constraints: prefer dedicated tools over bash for file reads, searches, and
edits; long-running commands show a progress spinner; cwd persists between
calls
version: 1.1.0
category: shell
aliases: [bash, shell, sh, terminal, run_command, execute_command, run_terminal_cmd, run_shell_command, exec_command] # other names a model may call it by; the model is shown only this tool's name
description: Execute a bash shell command and return its output. Use for running scripts, checking system state (git status, ls, etc.), or performing file operations. Press Ctrl+C to interrupt (partial output returned to LLM); press Ctrl+Z to background (use bash_job_wait to retrieve output).
constraints: prefer dedicated tools over bash for file reads, searches, and edits; long-running commands show a progress spinner; cwd persists between calls
outputFormat: plain text (stdout + optional stderr), truncated to 2000 lines
seeAlso: read_file, search_local, edit_file, write_file
parameters:
command:
type: string
description: The bash command to execute
required: true
Versions
| Version | Published | Status |
|---|---|---|
| 1.1.0 | 10/17/2026 | active |
| 1.0.0 | 10/11/2026 | active |
Details
- Author
- kdeps
- License
- Apache-2.0
- Latest Version
- 1.1.0
- Published
- 10/11/2026