kdeps-tools-exec
v1.0.0Run a shell command and return its structured result: success, exitCode, stdout, stderr, command, result and timedOut. Use through the exec component for pipeline steps that shell out. The command runs with sh -c (cmd /C on Windows) unless args are given. Optional: args, env, workingDir, timeout.
set tools / shelf tools
LLM context: ~240 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/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/exec@<version>.
Contents
Run a shell command and return its structured result: success, exitCode, stdout, stderr, command, result and timedOut. Use through the exec component for pipeline steps that shell out. The command runs with sh -c (cmd /C on Windows) unless args are given. Optional: args, env, workingDir, timeout.
| Parameter | Type | Description |
|---|---|---|
| args | array | Arguments for command. When set, command runs directly instead of through a shell. |
| command * | string | Command to run. Runs with sh -c (cmd /C on Windows) unless args are given. |
| env | object | Extra environment variables as key-value pairs; the process environment is inherited. |
| timeout | string | Hard stop for the command, e.g. '30s'. Default comes from kdeps defaults, then KDEPS_EXEC_TIMEOUT. |
| workingDir | string | Directory the command runs in. Default: the kdeps process working directory. |
version: 1.0.0
description: 'Run a shell command and return its structured result: success, exitCode, stdout, stderr, command, result and timedOut. Use through the exec component for pipeline steps that shell out. The command runs with sh -c (cmd /C on Windows) unless args are given. Optional: args, env, workingDir, timeout.'
parameters:
args:
type: array
description: Arguments for command. When set, command runs directly instead of through a shell.
command:
type: string
description: Command to run. Runs with sh -c (cmd /C on Windows) unless args are given.
required: true
env:
type: object
description: Extra environment variables as key-value pairs; the process environment is inherited.
timeout:
type: string
description: 'Hard stop for the command, e.g. ''30s''. Default comes from kdeps defaults, then KDEPS_EXEC_TIMEOUT.'
workingDir:
type: string
description: 'Directory the command runs in. Default: the kdeps process working directory.'
Versions
| Version | Published | Status |
|---|---|---|
| 1.0.0 | 10/21/2026 | active |
Details
- Author
- kdeps
- License
- Apache-2.0
- Latest Version
- 1.0.0
- Published
- 10/21/2026