Harnesses

Harnesses

A Harness is the tool that runs your agent, such as Claude Code or Codex. Pong connects to it; it doesn't replace it.

Which agent tools

Claude Code and Codex are fully supported, on Mac, Linux and Windows. Other agent tools can send Pings too, through a tool Pong adds to them.

What setup changes

pong setup finds each Harness on the computer and adds Pong to it. It does three things there:

  • It adds Pong's tools, which an agent uses to send you a Ping and wait for your Pong.
  • It adds a short instruction telling the agent to ask you through Pong, one question per Ping.
  • It hooks into the Harness's own prompts, like a request to run a command, so those reach you as Pings even when the agent didn't send one.

Settings shows each Harness as Installed and Connected once that's done.

Codex runs these hooks only after you trust them. If Settings warns about it, open Codex, run /hooks and trust Pong's.

How agents ask through Pong

An agent sends a Ping when it would otherwise stop and wait for you: a question, a plan to approve, a command it needs your OK for, or finished work. While it works, it can also write Thoughts, short lines about what it found or decided, which show in its Thread but never interrupt you.

You steer what agents send the same way you steer anything else they do: in your own instructions to the Harness, such as a CLAUDE.md or AGENTS.md file.

Where new Sessions open

When you start a Session from Pong, it opens in the Harness. For Claude Code you choose where in Settings: in Its app, where it starts without a window and moves into the app after its first turn, or in A terminal.

Pong only starts Sessions you can see. It never runs an agent in the background where you can't follow it.

When Pong isn't running

If Pong isn't running, or can't be reached, the agent asks you in the Harness the way it always did. Nothing waits on Pong. Choosing Answer in the Harness instead on a Ping does the same thing on purpose.

Repair

After updating Claude Code or Codex, or if Pings from one stop arriving, press Repair beside it in Settings. It sets Pong up in that Harness again. Running pong setup does the same for every Harness at once.