Skip to content

Tools

Agents

Every Claude Code and Codex session on this machine: what it is doing, how full its context is, and which one is waiting for you.


What is in the list#

Two agent tools: Claude Code and OpenAI's Codex CLI. Pip reads the files each one already writes — ~/.claude (or CLAUDE_CONFIG_DIR) and ~/.codex (or CODEX_HOME) — alongside the processes behind them. Run either one once in a project folder and the tab fills in.

Nothing needs installing in a project, and nothing is written back: no hooks, no changes to an agent's configuration, nothing written or locked under its data directory.

Reading a session#

A row is one session, named for the folder it runs in. Beside the name:

Status
Thinking, writing, working, or compacted and continuing while the agent is busy. Waiting for you once it has asked a question. Idle, with how long for, when it is ready for the next prompt — and a background shell that is still running is said separately.
Context
How much of the context window this session has used, and where it compacts. After a compaction the figure fills again from the next reply.
Model
The model behind the last reply, for the models Pip recognises.
API price
What these tokens would cost at the provider's list prices — see below. Optional.

Open a session for its tokens by kind — input, output, cache reads and cache writes — its subagent transcripts, its CPU and memory, and the folder and the app it runs in. The row menu copies the resume command or the session id, opens the folder, and brings the agent's own terminal or editor forward.

A session working in a git repository also carries its branch, in the words a server row uses — pip · main ↑2 — and its detail adds how the branch stands against its upstream, who you are committing as, and the repository's worktrees when there is more than one. What the git words mean.

The price figure#

The price is an illustration of token use, not an invoice. It is what a session's tokens would cost at Anthropic's or OpenAI's published API list prices, with the date of those prices shown beside the figure.

A subscription is not billed per token

On a Claude or ChatGPT plan you are not charged per token, so this figure is not what you pay. Claude Code's own background calls are left out, and messages Pip has no price for are excluded and said to be. Turn the figure off under Agent settings.

Being told instead of looking#

Three switches under Settings → Agent settings:

An agent finishes
The session has stopped working and is ready for your next prompt.
An agent needs you
It has asked a question and is waiting on the answer. The notification can bring the agent's own terminal or editor forward.
Context almost full
At a threshold you choose, so a long session is not a surprise.

They stay quiet while you are looking at the Agents tab — you can already see it.

Ending a session#

End session stops the agent process and everything it started, after a confirmation. The conversation is not lost: Pip shows the resume command that brings it back, and Copy resume command puts it on the clipboard for later.

End idle does the same to every idle session at once. If something an agent spawned outlives it, Pip says so rather than reporting a clean stop.

Elevated sessions

An agent started from an elevated terminal cannot be ended by an app that is not elevated, and Pip does not run elevated. It still lists the session and tells you why it cannot stop it.

Did this page not answer it? Tell us what you were looking for — that is how Pip's documentation gets written.