G
YouTube TikTok Games
@gent
DocsGetting started
Start

Getting started

Install the runner on the computer that has your projects. Then email your agent a task from any device.

What you need

  • A Gmail or Google Workspace account with IMAP turned on.
  • macOS or Linux, Python 3.11 or later, and uv.
  • Codex or Claude Code, installed and signed in. Claude Code needs version 2.1.259 or later.
  • A computer that stays awake and online while tasks run.
Note

Optional: choose campaign measurement before setup

If you came through the Google test and want to share coarse campaign counts, read the measurement guide before running atgent init. Its opt-in must happen before configuration to count a new configuration. Ordinary setup works without it.

Set it up

  1. Install

    Install the runner with uv.

    $ uv tool install atgent

  2. Create the config

    Guided setup asks for your Gmail address, how the runner signs in, your project folders and your agents. It writes no secret to the config.

    $ atgent init

  3. Give it Gmail access

    Create a Google app password and keep it in your keychain. Gmail sign-in has the steps, and the OAuth option for accounts that block app passwords.

  4. Check

    Doctor checks Gmail over IMAP and SMTP without sending mail, then checks each agent.

    $ atgent doctor

  5. Start at login

    The login service starts the runner after you sign in and restarts it after a failure.

    $ atgent install-service
Note

Wait for the runner before the first email.

The first successful check skips old Sent mail. Send your first task after Mailbox intake armed; runner ready appears in state/service.log beside your config.

YCodex: improve the signup formSkipped
2026-10-13 09:41:02,118 INFO Intake armed for new messages; historical Sent mail skipped
2026-10-13 09:41:02,131 INFO Mailbox intake armed; runner ready
YCodex: improve the signup formAccepted
2026-10-13 09:52:17,604 INFO Accepted task 3f9c2a7e
RunnerRe: Codex: improve the signup form · Queued: codex / main / agent default / headless
  1. This task was sent before the runner started. It stays in Sent and the runner never reads it.
  2. The first successful check records where Sent ends. Mail up to that point is skipped.
  3. Send your first task after this line appears in state/service.log.
  4. The runner accepts the new task and replies Queued in the same thread.
The same task sent twice: once before the ready line and once after it. Only the second one runs.

Send a task

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

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

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

You get Queued, Started and the result in the same thread. Reply to continue the same session. Reply status for progress or stop to stop the task. The subject line lists every setting.

Next

Checked against atgent 0.6.5.