DevTools

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

import { createAgentDevtools } from "@phaseo/agent-sdk";

const result = await agent.run({
  input,
  client,
  devtools: createAgentDevtools(),
});

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

Configure the output directory

const devtools = createAgentDevtools({
  directory: ".local/agent-runs",
});

await agent.run({ input, client, devtools });

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 October 18, 2026

Start Here

Build

Observe

Reference

Enable capture for one run

Configure the output directory

Captured information

​Enable capture for one run

​Configure the output directory

​Captured information

​Related guides

Enable capture for one run

Configure the output directory

Captured information

Related guides