From 27aa222c55a55094b968857a720798cb686e0e84 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Mar 2026 04:47:20 +0000 Subject: [PATCH 1/2] Fill in empty "Handling Long-Running Commands" README section The section had a heading and placeholder text but no actual content. Added a concise numbered list covering the key workflow: starting processes, reading output with pagination, sending input, listing sessions, and terminating processes. https://claude.ai/code/session_01P3h7kRs1h8o1QvbTj21xbc --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index c7b0df94..fa11dcff 100644 --- a/README.md +++ b/README.md @@ -761,6 +761,12 @@ This audit trail helps with debugging, security monitoring, and understanding ho For commands that may take a while: +1. **Start the process** — Use `start_process` with a short `timeout_ms` to capture initial output. The process continues running in the background and returns a PID. +2. **Read output** — Use `read_process_output` with the PID to get new output. Use `offset` and `length` for pagination: `offset=0` returns output since the last read, a negative offset (e.g., `-50`) returns the last N lines. +3. **Send input** — Use `interact_with_process` to write to stdin of a running process, useful for REPLs, SSH sessions, and interactive prompts. +4. **List sessions** — Use `list_sessions` to see all active and recently completed processes. +5. **Terminate** — Use `force_terminate` with a PID to kill a running process. + ## Configuration Management ### ⚠️ Important Security Warnings From 160d14fd0103e0566fafe77f97dd6e60b58343aa Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Mar 2026 04:50:10 +0000 Subject: [PATCH 2/2] Fix inaccuracy in long-running commands section list_sessions only shows active processes, not completed ones. The listCompletedSessions() method exists but is not called by the tool function. https://claude.ai/code/session_01P3h7kRs1h8o1QvbTj21xbc --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index fa11dcff..9c07abbe 100644 --- a/README.md +++ b/README.md @@ -764,7 +764,7 @@ For commands that may take a while: 1. **Start the process** — Use `start_process` with a short `timeout_ms` to capture initial output. The process continues running in the background and returns a PID. 2. **Read output** — Use `read_process_output` with the PID to get new output. Use `offset` and `length` for pagination: `offset=0` returns output since the last read, a negative offset (e.g., `-50`) returns the last N lines. 3. **Send input** — Use `interact_with_process` to write to stdin of a running process, useful for REPLs, SSH sessions, and interactive prompts. -4. **List sessions** — Use `list_sessions` to see all active and recently completed processes. +4. **List sessions** — Use `list_sessions` to see all active processes. 5. **Terminate** — Use `force_terminate` with a PID to kill a running process. ## Configuration Management