# Email coding tasks to your own computer

> Source: <https://dev.to/kyisaiah47/email-coding-tasks-to-your-own-computer-3ok>
> Published: 2026-10-15 17:13:31+00:00

You can remember a signup form problem while you are away from your computer. You can email yourself the task from your phone. You send the message from your own Gmail account to your own address with `+agents` added. Gmail delivers the message to your normal inbox, so you need no new email account.

You write the task in the email body. You can send plain text or HTML email. You can attach files, and atgent gives the saved attachment paths to the agent.

A signup form task can ask an agent to improve confusing parts of the form and run the relevant checks. Your computer can stay at home while you send the task from another device.

You install atgent on the computer that holds your projects. The runner reads your Gmail Sent folder, not your Inbox. It starts Codex or Claude Code in a configured project with your existing sign-in.

Your repositories and agent sign-ins stay on your computer. Task text and results travel through Gmail and your chosen agent provider. Tasks for different projects can run at the same time.

The runner sends `Queued`, `Started` and the result as replies in the task thread. The result is the agent's final message as formatted email. Every reply ends with the task ID and the command to open it in your terminal.

Only mail that you send from your own Gmail account can start a task. Mail from other people lands in your Inbox. The runner does not read your Inbox, so their mail cannot start a task. Anyone who can add mail to your Sent folder can also send tasks, so you must protect your Gmail account and its credentials.

The subject line selects the agent, project, model and run mode. Agent names ignore case. Project names are case sensitive. The task body contains the instruction.

`Codex: improve the signup form` runs Codex in your default project.

`Claude: improve the signup form` runs Claude Code in your default project.

`Codex/website: fix the footer links` runs Codex in the project named website in your config.

`Claude [opus]: review the auth flow` runs Claude Code with the opus model. Replies in the thread keep that model.

`Codex/website [gpt-6.1-sol]: fix the build` runs Codex in the website project with the gpt-6.1-sol model.

`Claude [opus, terminal]: review the auth flow` opens Claude Code in a new Terminal window and uses the opus model.

Without a model in brackets, the configured default model runs. Add `headless` in the brackets to run the task in the background. Add `terminal` in the brackets to open the task in a Terminal window.

You can reply in the same thread to continue the same agent session. The agent keeps the earlier turns. A reply of `status` returns progress by email. A reply of `stop` cancels queued turns and stops the running agent. Changes that the agent already made stay in your project.

Approval emails let you approve or deny a blocked action from your phone. Each approval covers one action. You reply directly to the approval email with `approve` or `deny`. Silence becomes a denial after the configured timeout.

With approvals off, Codex uses its configured sandbox and approval policy. Claude Code denies actions that need approval by default. You review the work before you publish or deploy it.

When you return to your computer, run `atgent list` to see each email task with its agent, model and status. Select a task and press Enter to resume the same session in your terminal. The agent then answers in the terminal instead of by email. A reply resumes a Claude terminal session. Codex terminal sessions are not tracked, so a reply opens a new window.

Install uv first. Then install Codex or Claude Code and sign in. Install the runner with `uv tool install atgent`. Run `atgent init` to enter your Gmail address, sign-in method, project folders, installed agents and default models. The setup writes no secret to the config.

Turn on IMAP in Gmail. Create a Google app password, or use your own Gmail OAuth desktop client when app passwords are blocked. Keep the app password in your OS keychain or in the `AGENT_MAILBOX_PASSWORD` environment variable. Never put it in the config file.

Run `atgent doctor` to check Gmail over IMAP and SMTP without sending mail. The command also checks that Codex and Claude Code are installed. Run `atgent start` to start the runner in the background. Its first check skips old Sent mail, so send your first task after that check.

atgent needs Gmail with IMAP access, macOS or Linux, Python 3.11 or later, uv, and a computer that stays awake and online. You need Codex or Claude Code installed and signed in. Claude Code needs version 2.1.259 or later.

HTML email, attachments, concurrent projects, approval email replies with both agents, and the login service were tested live on macOS. Linux and Gmail OAuth are unit-tested only.

atgent is free and MIT licensed. Your existing Codex or Claude Code plan and its limits apply.
