Create a tool in the workbench

Draft a tool with the tool drafter, test-run it, and save it.

merged_prs lists the pull requests merged since a date by running the gh CLI.

.graph/tools/merged_prs.yaml

name: merged_prs
description: Pull requests merged into this repository since a date, as number, title and merge time.
kind: exec
command: gh
args:
  - pr
  - list
  - --state
  - merged
  - --search
  - "merged:>={{input.since}}"
  - --json
  - number,title,mergedAt
read_only: true
input_schema:
  type: object
  required: [since]
  properties:
    since:
      type: string
      description: The earliest merge date, as YYYY-MM-DD

1. Open the workbench in tool mode

   graph workbench tool
   
2. Describe the tool

   Say what goes in, what comes back, and which command or API it uses. The drafter checks your catalog for a tool that already does it, then puts a first draft in the pane and asks what it can’t settle itself.

   

   The tool drafter's first draft in the pane, with its question in the chat.

3. Test-run it

   Answer its questions and ask it to test the tool. It runs the draft on a sample input once you approve the run:

   

   The approval form for a test run, showing the command and the sample input.

   The result shows in the pane:

   [
     {
       "mergedAt": "2026-10-09T02:25:01Z",
       "number": 147,
       "title": "feat!: plans state how they finish with a required finish key…"
     },
     {
       "mergedAt": "2026-10-08T19:34:56Z",
       "number": 146,
       "title": "feat!: workbench agents work on plans through the same artifact tools…"
     },
     …
   ]
   
4. Save

   Press Ctrl+S. graph writes the file to ./.graph/tools/merged_prs.yaml, and the tool is in your catalog as user__merged_prs.

Related guides

Test a tool

Run any tool directly and see what it returns.

Tool file

Every field a tool file takes.

Create an agent in the workbench

Draft an agent that calls your tool.

Draft a plan in the workbench

Draft a plan that uses your tool.