Wardterm documentation

AI agents

Follow Claude Code, Codex and Gemini CLI in your Wardterm SSH sessions: see every AI agent in one place, answer its questions and send it a message.

Open Agents

Agents is part of Pro. It shows the AI tools at work in your sessions, such as Claude Code, Codex and Gemini CLI.

  • On Mac and iPad: the Agents tab, next to Files in the tab bar. It appears while an AI tool runs in one of your sessions. A number on it says how many agents wait for you.
  • On iPhone: tap the square at the bottom of the terminal. The Agents section is on top of your sessions, with a card for each agent, and the square shows how many wait for you. Tap a card to open the agent on its own page. In the session menu, Agents opens the agent of that session.

Without Pro, Agents shows the Pro badge and what it does.

The list of agents

On Mac and iPad, the list on the left has every AI agent found in your sessions, in every window, the ones that wait for you on top. The agent you choose opens on the right.

Each agent shows its tool, its server and session, how long it has been in the current turn, and its state:

  • Working
  • Waiting for you
  • Done
  • Error
  • Ready

A sign marks an agent whose session is kept if the connection drops. See Keep sessions alive.

The agent

The page of an agent shows its state, the time in the turn, the tokens of the turn and the context left when they are known, and its task list.

  • Go to terminal opens its session.

Answer a question

When the agent asks a question, its real choices appear as buttons. A tap types that choice in the session, only if the question is still on screen. On a server with Environment set to Production, Wardterm asks first.

Send a message

Write a message to the agent in the field, then choose Send.

Dictate uses the microphone and the speech recognition of your device. Read the text, then tap Send.

Controls

The page shows the controls the tool offers:

  • Model
  • Effort, in Claude Code
  • Permissions, in Codex
  • Mode, with Next mode, the same as Shift+Tab in the tool. The current mode is shown when the screen shows it.

A command is typed only when the agent is at its prompt.

On the Lock Screen

On iPhone and iPad, turn on Show AI agents in Settings, Sessions. The Live Activity shows each agent with its state and question, and Yes, No or Open. In the Dynamic Island, Agents waiting counts the agents that wait for you.