> ## Documentation Index
> Fetch the complete documentation index at: https://graph.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# The workbench
> Find your way around graph's terminal UI for building and testing agents, plans and tools.
The workbench is a full-screen terminal UI where you build agents, plans and tools by talking to graph's built-in agents, then run and debug them in the same window.
## Open it
```bash theme={null}
graph workbench
```
It opens at the front desk, which asks what you want to build. To go straight to a mode, name it, and optionally the file to open:
```bash theme={null}
graph workbench plan unreleased_changes
graph workbench agent release_notes
graph workbench tool merged_prs
```
`graph wb` is short for `graph workbench`. The workbench needs an interactive terminal. In scripts and CI, use [`graph plan run`](/plans/guides/run-a-plan).
## Layout
* **Chat**, on the left: you talk to the workbench's agents. The pane title names the agent you're talking to.
* **Workspace**, on the right, with three tabs:
* 1 the plan, agent or tool you're working on, with the selected row's detail below it.
* 2 the tool catalog the agents draft from.
* 3 the latest run.
## Who you're talking to
The front desk hands you to the plan drafter, the agent drafter or the tool drafter. Once a plan is drafted or opened, the plan editor takes over. The plan drafter and plan editor can hand you to the tool or agent drafter when a plan needs a new tool or agent, and those drafters hand you back when they're done.
To switch by hand, type `/agent ` in the chat. See [Built-in agents](/agents/reference/built-in-agents) for what each one does.
## Saving
Ctrl+S saves what's in the workspace: plans to `./.graph/plans/`, agents to `./.graph/agents/` and tools to `./.graph/tools/`, ready to commit. A file you opened is saved in place.
## Keys
Tab moves focus between chat and the workspace. Most keys act on the workspace, so press Tab first when you're typing in chat.
| Key | Does |
| - | - |
| Enter | Chat: send. Alt+Enter adds a new line |
| 1 2 3 | Switch workspace tab. Alt+1 works from chat |
| j k | Select a step or tool |
| e | Edit the selected step in a form |
| a / A | Add a step after / before the selected one |
| PgUp PgDn | Scroll the focused pane |
| v | Validate the plan |
| r | Run the plan |
| g | Debug run: pause at each breakpoint, or before every call when there are none |
| b | Toggle a breakpoint on the selected step |
| u | Undo the last time an agent replaced the draft. Press again to redo |
| x x | Discard the agent or tool draft |
| Ctrl+S | Save |
| ? | Show the keys |
| q | Quit |
While a debug run is paused:
| Key | Does |
| - | - |
| n | Run this call and pause at the next one |
| c | Continue to the next breakpoint or error |
| s | Skip this call and give it a result, or replace a failed call's result |
| a | Abort the run |
## Mouse
| Action | Does |
| - | - |
| Click a pane | Focus it |
| Click a tab | Switch to it |
| Click a row | Select it |
| Double-click a row | Edit it |
| Scroll | Scroll the pane under the pointer |
## Logs
The workbench writes its log to `workbench.log` in the [data directory](/reference/data-directory), not to the terminal. Set `GRAPH_WORKBENCH_LOG` or `[workbench] log_path` to change the path, and `GRAPH_LOG` to change what it records.
## Guides
> **[Draft a plan in the workbench](/plans/guides/draft-in-workbench)**
>
> Describe a goal and get a plan you can run.
> **[Debug a plan](/plans/guides/debug-a-plan)**
>
> Pause at a breakpoint, find the bad input and fix the step.
> **[Create an agent in the workbench](/agents/guides/create-in-workbench)**
>
> Draft an agent with tools and save it.
> **[Create a tool in the workbench](/tools/guides/create-in-workbench)**
>
> Draft a tool, test-run it and save it.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.