kdeps-commands-efficiency
v2.0.0kdeps command: efficiency
set commands / shelf agent
PurposeShow or tune efficiency enforcement (soft stops on read-only loops; persists)
LLM context: none - kdeps uses it without sending it to the model
Where it runs
Part of the commands set, used in workflow and agent mode. Slash commands: the help and completion of the built-in ones, and declared commands that run other commands and prompts.
- you type /name in kdeps
- the command runs: built in, or its declared stepscommands/efficiency
- prompts go to the model; the output is shown
Loaded by: kdeps (agent loop), /update, kdeps run
In the code: kdeps (agent loop)agent.(*REPL).Runagent.declaredCommand
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.
Also installs what it requires, when missing or older: tools/session_ops.
Pin a version with kdeps install commands/efficiency@<version>.
Contents
- order
- 290
/efficiency [on|off|verbose on|off|prompt auto|full|summary|<setting> <n|off>|preset <name>|reset]Show or tune efficiency enforcement (soft stops on read-only loops; persists)/efficiency state [on|off]Show or set enforcement on or off/efficiency- 1
Calls a kdeps API tool
session_opsoperation: efficiencyprints
**Efficiency enforcement** ``` state {{.value}} verbose {{.verbose}} prompt {{printf "%-8s" .prompt}} harness text after the first send reads {{printf "%-4s" .limits.reads}} consecutive read-only calls before a stop actions {{printf "%-4s" .limits.actions}} tool calls per turn before a stop stops {{printf "%-4s" .limits.stops}} soft stops per turn before the turn ends failures {{printf "%-4s" .limits.failures}} failed tool/LLM calls briefed and retried per turn tighten {{printf "%-4s" .limits.tighten}} reads budget lost per stop web {{printf "%-4s" .limits.web}} web calls per turn bash {{printf "%-4s" .limits.bash}} read-only bash calls per turn file {{printf "%-4s" .limits.file}} file read/list/search calls per turn code {{printf "%-4s" .limits.code}} sql/code-inspection calls per turn ``` Usage: `/efficiency [on|off|verbose on|off|prompt auto|full|summary|<setting> <n|off>|preset <name>|reset]`
/efficiency stateShows or sets the session setting efficiency to one of onoff. What it prints is the setting block below.
/efficiency on- 1
Runs a command
/efficiency state on
/efficiency off- 1
Runs a command
/efficiency state off
/efficiency verboseShows or sets the session setting efficiency-verbose to one of onoff. What it prints is the setting block below.
/efficiency promptShows or sets the session setting efficiency-prompt to one of autofullsummary. What it prints is the setting block below.
/efficiency reset- 1
Calls a kdeps API tool
session_opsoperation: efficiency_resetprints
efficiency settings reset to defaults (saved)
/efficiency preset- 1
Calls a kdeps API tool
session_opsoperation: preset_apply name: $1prints
preset {{.name}} applied: all harness and efficiency values overwritten (saved)
/efficiency *- 1
Calls a kdeps API tool
session_opsoperation: efficiency_limit setting: $1 value: $2prints
efficiency {{.setting}} {{if eq .value "off"}}limit off{{else}}= {{.value}}{{end}} (saved)
requires:
tools/session_ops: ""
version: 2.0.0
# kdeps update installs these with this command: what its run steps use
requires:
tools/session_ops: ""
name: efficiency
order: 290
usage:
- args: "[on|off|verbose on|off|prompt auto|full|summary|<setting> <n|off>|preset <name>|reset]"
help: Show or tune efficiency enforcement (soft stops on read-only loops; persists)
- args: "state [on|off]"
help: Show or set enforcement on or off
subcommands:
"":
run:
- tool: session_ops
args: {operation: efficiency}
print: |-
**Efficiency enforcement**
```
state {{.value}}
verbose {{.verbose}}
prompt {{printf "%-8s" .prompt}} harness text after the first send
reads {{printf "%-4s" .limits.reads}} consecutive read-only calls before a stop
actions {{printf "%-4s" .limits.actions}} tool calls per turn before a stop
stops {{printf "%-4s" .limits.stops}} soft stops per turn before the turn ends
failures {{printf "%-4s" .limits.failures}} failed tool/LLM calls briefed and retried per turn
tighten {{printf "%-4s" .limits.tighten}} reads budget lost per stop
web {{printf "%-4s" .limits.web}} web calls per turn
bash {{printf "%-4s" .limits.bash}} read-only bash calls per turn
file {{printf "%-4s" .limits.file}} file read/list/search calls per turn
code {{printf "%-4s" .limits.code}} sql/code-inspection calls per turn
```
Usage: `/efficiency [on|off|verbose on|off|prompt auto|full|summary|<setting> <n|off>|preset <name>|reset]`
state:
setting:
key: efficiency
values: ["on", "off"]
show: "efficiency enforcement {{.value}}"
set: "efficiency enforcement {{.value}} (saved)"
invalid: "Usage: /efficiency on|off"
"on":
run:
- command: /efficiency state on
"off":
run:
- command: /efficiency state off
verbose:
setting:
key: efficiency-verbose
values: ["on", "off"]
show: "efficiency verbose {{.value}}"
set: "efficiency verbose {{.value}} (saved)"
invalid: "Usage: /efficiency verbose on|off"
prompt:
setting:
key: efficiency-prompt
values: [auto, full, summary]
show: "efficiency prompt {{.value}}"
set: "efficiency prompt {{.value}} (saved)"
invalid: "usage: /efficiency prompt auto|full|summary"
reset:
run:
- tool: session_ops
args: {operation: efficiency_reset}
print: efficiency settings reset to defaults (saved)
preset:
run:
- tool: session_ops
args: {operation: preset_apply, name: "$1"}
print: 'preset {{.name}} applied: all harness and efficiency values overwritten (saved)'
"*": # /efficiency <setting> <n|off>
run:
- tool: session_ops
args: {operation: efficiency_limit, setting: "$1", value: "$2"}
print: "efficiency {{.setting}} {{if eq .value \"off\"}}limit off{{else}}= {{.value}}{{end}} (saved)"
Versions
| Version | Published | Status |
|---|---|---|
| 2.0.0 | 10/24/2026 | active |
| 1.0.1 | 10/21/2026 | active |
| 1.0.0 | 10/12/2026 | active |
Details
- Author
- kdeps
- License
- Apache-2.0
- Latest Version
- 2.0.0
- Published
- 10/12/2026