Skip to content

Glossary

Agent action

Last updated

Definition

An agent action is a request from an AI coding agent for a tool to do something on its behalf, such as starting another chat or running a job, rather than only reading information.

Also called: agent request, tool action.

Coding agents such as Claude Code and Codex call tools, often through an MCP server. Many tools only read (list files, fetch an issue); an action changes something or starts work. Because an agent's model can be steered by what it reads, a prompt injection in a file for example, actions are where a person usually wants a say.

What makes actions safe to allow

  • Approval outside the agent: the decision is made by a person or a rule, never by anything the agent sends.
  • No escalation: whatever the action starts gets no more access than the agent that asked.
  • Depth limits: agents started by agents can ask for less, so a chain can't grow by itself.
  • Budgets and a kill switch: a cap on how many and how often, and one switch that stops them all.
  • A log: every request, decision and outcome can be read afterwards.

In Pairbar

With Pairbar's tools installed, a Claude or Codex chat can ask for a second opinion or a review from the other app, a helper chat, a handoff, a follow-up to its own helpers, a notification, a workflow run or draft, or a check-in on itself. Each request gets an approval ticket and runs only if your settings allow it or you approve it in Pairbar; an agent can never approve anything. Guardrails are checked in order: paused or off, depth, no escalation, recent declines, repeats, budgets and the plan floor. See approve agent actions.

Every request is checked in this orderrefused with1Agent actions paused, or this kind is Offpaused_by_user · turned_off2Too deep: a helper may only ask for a second opinion or a reviewtoo_deep3More access than the asking chat has itselfno_escalation4You declined 3 of its requests in 10 minutes (paused 1 h)limited5The same request in the last 10 minuteslimited6Budgets (3 per chat, 8 an hour, 6 at once, 30 a day) or under 25% of a plan leftlimitedRunsAllow for this kind, a 1-hour grant for this chat,or a workflow you marked Agents may run thisWaits for your ApproveEverything else. Agents never approve;unanswered requests expire after an hour
The checks every agent request passes, in order, before it runs or waits for you.

Frequently asked questions

What's the difference between a tool call and an agent action?
Every agent action is a tool call, but not every tool call is an action. Reading tools only return information; actions start or change something, which is why they usually need approval.
Can an agent approve its own actions in Pairbar?
No. Only your click in Pairbar, a setting you chose, or a one-hour grant you ticked lets a request run.
Do Pairbar's agent actions cost extra?
Not from Pairbar. Helpers run with your own claude and codex command-line tools, on your own plans.