Enkaidu

Wed, 16 Sep 2026 13:45:19 -0400

Shell Command Execution

As of 0.9.11 the ShellAccess toolset is no longer available. The shell_command tool is a now a system-level tool which can be enabled using a session configuration property documented here

`shell_command`

Executes one of the allowed shell commands within the current project’s root directory and returns the shell command’s output.

Heads up! The tool tries to err on the side of caution and detect and prompt you for confirmation even when you’ve approved commands but built-in (and custom) restricted strings are detected. Regardless, you and only you are responsible for the outcome of any commands run via this tool.

Wed, 26 Aug 2026 21:18:36 -0400

In-memory global state

As of 0.9.10

Use of in-memory global state via tool calling must be allowed by enabling the session configuration allow_global_state.

`get_global_state`

Get the values for one or more keys within a namespace in the global state available across sessions and turns, including the monotonically increasing revision number for the namespace

Parameters

Parameter	Type	Required	Description
`namespace`	String	Yes	A namespace is a container of key/value pairs
`keys`	Array of Strings	Yes	An array of one or more keys for which to retrieve the values. Unknown keys will return a `null` value.

`set_global_state`

Set (or update) the value for one or more keys within a namespace in the global state available across sessions and turns.

Wed, 26 Aug 2026 21:18:36 -0400

Sub-Agents

Use of sub-agents must be allowed by enabling the session configuration allow_sub_agents. This in turn ensures the system prompt includes guidance on how and when to use sub-agents automatically when responding to user requests.

`spawn_agent`

Run a prompt in a completely fresh, isolated context window and receive the result as [query, response]. Ideal for consuming large amounts of tokens, handling self‑contained tasks, or avoiding context pollution.

Parameters

Parameter	Type	Required	Description
`prompt`	String	Yes	The full instruction for the sub‑agent; be explicit, especially when not including history.
`include_caller_history`	Boolean	No	Set to true only when the task requires awareness of the current session (e.g., summarizing, continuing a thread). Defaults to `false`.

Notes

The tool spawns a temporary session, executes the prompt, and returns the query‑response pair. It is useful for multi‑step research or large codebase analysis.

Wed, 26 Aug 2026 21:18:36 -0400

Tool Discovery

Tool discovery must be allowed by enabling the session configuration allow_tool_discovery.

`install_tools`

Install one or more tools from the list of installable tools. Tool names are unique across toolsets.

Parameters

Parameter	Type	Required	Description
`tools`	List of strings	Yes	List of one or more tools to install so they are available to call afterwards

Notes

The user must confirm the installation before the tools are loaded.
Installation is performed across toolsets, and the function returns a JSON payload indicating success or partial success.

`list_installable_tools`

Obtain a list of available tools that you can install. Use the list to determine the tools that will help with your task. IMPORTANT: YOU MUST install a tool from this list BEFORE you can call it.