PhaseDrift

Connect your coding agent

Setup instructions and available measurements for each host.

Connect the project first

Run in the repository where the agent works:

phasedrift init --host codex --local-only
phasedrift open

This fresh-project command requires PhaseDrift 0.4.21 or later. It selects Codex and explicitly keeps hosted history and cloud report analysis off. Choose another host with --host opencode, --host claude-code, --host gemini-cli, --host cursor, or --host all; hook-based hosts install only their selected project integration. Reload the project instructions afterward.

Codex

Start the next task with the project's AGENTS.md instructions loaded. The reporting skill asks Codex to save what changed, what it checked and what got in the way.

Recorded activity: tool calls, token usage and time for complete runs, when present in the local logs.

Check the connection:

phasedrift session status

After a completed task, open Agent work → Reports and find its report. Use Effort to inspect the recorded run.

Verify a real task

Finish one ordinary task. Find its saved result in Agent work → Reports, then inspect the matching activity in Effort when available. These are separate checks: collected tool calls do not mean a report was saved.

phasedrift doctor
phasedrift harness status
phasedrift learning reports

No activity for a host? Confirm it has local records for this repository and read the collection status before assuming the adapter is broken.

Refresh an existing setup

phasedrift init --host codex --upgrade

This refreshes only the selected host's PhaseDrift-owned instructions, preserving unrelated hooks and settings. Choose the host you already use; hook-based hosts require explicit selection. It installs no global hook and makes no paid analysis call.

Compare similar work within the same host and model. Token accounting differs across hosts, and unavailable fields remain missing.

Custom instruction filenames

Codex and Cursor use the shared AGENTS.md block. Claude can load it alongside custom Claude files using claude-md-and-agents-md in /config; verify with /context.

Gemini's GEMINI.md entry point loads the shared skill. For custom filenames, context.fileName in .gemini/settings.json can include both AGENTS.md and GEMINI.md. Preserve other entries and check /memory show.

Muse or another reporting host

Start a task with the actual host name:

phasedrift session start --task "Your objective" --area verification --host muse

Keep the returned attempt. Close using its exact review command. Each concurrent agent keeps its own handle.

This records task feedback; it does not create native runtime or token data. Windsurf, Cline/Roo Code and Aider do not have native activity adapters today.

On this page