knoopx shell-session Tool
Stateful bash: cd, env vars, and job state persist across calls.
REQUIRED: command (one shell command, NOT a script) OPTIONAL: timeout (seconds; default 30, use 120–300 for installs/builds)
RULES:
- ONE command per turn. Read the output before proposing the next.
- State persists: set vars / cd once, reuse later.
- Never run interactive commands (
vi,less,top,pythonbare REPL). Use non-interactive equivalents (cat,sed -i,python -c '…'). - Output ends with
[exit=N cwd=… timed_out=…]— check exit=0 before claiming success. - If timed_out=true, do NOT just retry; diagnose (longer timeout, narrower command).
EXAMPLE:
{"name": "shell-session", "input": {"command": "cd /work && ls -la"}}
EXAMPLE with timeout:
{"name": "shell-session", "input": {"command": "pip install -q requests", "timeout": 180}}
Workflow
- One command at a time: Run a single command, read output, then proceed
- Leverage state: Set env vars or cd once, reuse in subsequent commands
- Check exit code: Verify
exit=0in the footer before assuming success - Handle timeouts: If
timed_out=true, diagnose the cause rather than retrying blindly - Avoid interactivity: Never run editors, pagers, or REPLs; use non-interactive equivalents