Skip to main content
Use Agent SDK DevTools capture during development when you need a local record of run inputs, steps, tools, outputs, timing, and gateway correlation IDs.

Enable capture for one run

By default, files are written under .phaseo-devtools in the current working directory.

Configure the output directory

You can also set PHASEO_DEVTOOLS=true and optionally PHASEO_DEVTOOLS_DIR for local development processes.

Captured information

Each agent.run or agent.continue entry includes:
  • agent and run IDs
  • run status and duration
  • input and application context
  • model and provider details when available
  • gateway request and native response IDs
  • step and tool counts
  • completed run state, messages, steps, and output
  • structured failure details when a run throws
Agent inputs, messages, tool results, and application context may contain sensitive data. Keep the DevTools directory out of source control and apply the same access controls as other development logs.
Last modified on July 26, 2026