Features

The subject line

The subject starts with the agent. The remaining words set the task options in any order. The body contains the task.

The subject names the agent. The body is the task. Send it to your +agents address from your own Gmail.

To: you+agents@gmail.com
Subject: codex

Find the confusing parts of the signup form, improve them,
and run the relevant checks.

After you name the agent, add settings to the subject in any order. You do not need a colon or brackets. Claude Code and claude name the same agent, and capitalization does not matter.

claude headless opus
Claude Code opus 5.5 terminal
codex website astra
claude codex 30m high

Settings

claude, codex, gemini, opencode, aider, cursor

Picks the agent. It comes first. Two agent words run both agents side by side.

a project alias, such as website

Picks a project from your config. Without one, atgent uses default_project.

a model, such as opus, opus 5.5 or astra

Picks the model for this task.

headless or terminal

Runs the task in the background or opens it in a Terminal window.

30m, 2h, 90s

Stops each turn after the selected time.

low, medium, high, xhigh, max

Sets the agent's reasoning effort.

readonly

The agent investigates and reports. It does not change files.

pr

atgent opens a pull request when the turn finishes.

here

Runs the task in the project folder, not on a task branch.

daily 9am, weekdays 8:30, every monday, tomorrow, in 2h, every 6h

Turns the email into a schedule.

Models

A Claude model can use a short name such as opus or a family and version such as opus 5.5; atgent converts it to claude-opus-5-5. atgent matches a Codex model against the models your Codex sign-in lists, so astra selects gpt-6-astra and 6.1 sol selects gpt-6.1-sol. The selected model applies to every reply in that thread and to a local resume. Without a model, the agent uses its default model from the config.

Words that are not settings

A word that is not a setting does not stop the task. The task runs with the defaults, and the Queued reply names each ignored word. A subject that does not start with an agent or shortcut is not a task, so other mail to the address does nothing. The older Claude/website [opus, terminal]: text form still works.

The Queued reply lists the agent, project, model and mode for the task. You can check the subject against the first reply.

Checked against atgent 0.4.4.