Toolkit — Scape

The Toolkit is a button grid in the right sidebar that gives you one-click access to reusable actions. Each tool can send a prompt to an agent, run a shell script, or launch a playbook.

Built-in tools

Scape ships with five built-in tools:

Create PR — generates a pull request from the current branch
Commit & Push — stages, commits, and pushes changes
Diff Summary — summarizes the current diff
Run & Fix Tests — runs tests and fixes failures
Review PR — reviews the current pull request

Tool modes

Each tool operates in one of three modes:

Mode	Description
Prompt	Sends text to the active session. Optionally opens a new interactive session.
Script	Runs a shell command via `/bin/bash -c`.
Playbook	Launches a Scape playbook by ID.

Creating custom tools

Open the Manage Tools modal from the toolbar. You can:

Create — define a tool manually with a name, emoji icon, mode, and body.
Generate — describe what the tool should do and let AI build it.
Import — import tool definitions from a file.

Each tool has:

Name and emoji icon
Mode (prompt, script, or playbook)
Body — the prompt text, script, or playbook reference
Keyboard shortcut (optional)
MCP-exposed toggle — whether agent sessions can discover and run it
Interactive toggle — for prompt mode, whether to open a new session

Cross-tool references

Tools can reference other tools using #tool:<slug> syntax, which is recursively expanded (up to depth 5). This lets you compose complex workflows from simple building blocks.

Storage

Custom tools are stored at ~/.scape/tools.json. Hidden tools (ones you've dismissed from the grid) are tracked in ~/.scape/hidden-tools.json.

MCP tools

Agent sessions can discover and invoke your custom tools:

Tool	Description
`list_custom_tools`	List available tools (optionally include unexposed ones)
`run_custom_tool`	Run a tool by ID in the active session