Home / Projects / NiPlex-Harness / Tools / Shell tools / shell_kill

Pictures

shell_kill

Interrupts, terminates, kills or closes a session.

Since 2 Sept 2026

Interrupts, terminates, kills or closes a session.

Tool name: shell_kill
Group: Shell
Risk: low
Needs approval: never
Approval rule: No approval.
Allowed in scheduled jobs: No
Default: off

Parameters

Name	Type	Required	Default	Meaning	Limits
session	string	No	main	Name of a persistent shell session.
mode	string	No	interrupt	How hard to stop the process.	One of: interrupt, terminate, kill, close.

Returns

A confirmation.

Example (made up for this page)

Call

{}

Result

Interrupted main.

Side effects

Stops a running process.

How it can fail

When	What the agent sees
No such session	Not found text

See also:Shell tools

Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.