Guides / What to email your agent
What to email your agent
Anything you'd ask a coding agent at your desk, from wherever you read email. Tasks run on your computer, so they can use your repos, tools and files.
Good first emails
- A fix from your phone. "The footer on personal-site overlaps the last section on phones. Can you fix it?" It finds the project, makes the change and tells you what it ran. Say "don't deploy" if you want to review first.
- Questions about a repo, read only. "In the billing project, where is the refund total rounded? Read only." Good for when you're away from the code.
- Summaries of what you attach. Attach a PDF, spreadsheet or notes and ask for the three things that matter.
- Reports with a file. "Compare these two quotes and send me a one-page .docx." Files up to 3.5 MB come back attached to the reply.
- Chores that wait for you. If your computer is asleep the email waits and runs when it's back.
Keep going in the thread
Reply to continue: the agent resumes the same session with its context. If the task is still running, your follow-up can steer it ("only cover the EMEA tab") or wait its turn if it's a different job. A bare "thanks" is simply dropped.
Choose the project, model and effort
| You want | Write |
|---|---|
| A specific project | "In personal-site, …" or Work in /Users/you/code/site |
| A specific model | "Use Luna on low reasoning" or a first line Model: gpt-6-luna |
| More thinking | "Think harder about this, high effort" |
| A file back | "Send me the result as report.docx" |
Standing instructions
Tell the agent once how you work, for example where files that are too large for email should go: tagmails set --instructions "For files over 3.5 MB, upload them to my Drive and reply with the link." You can also ask by email ("make Sol my default").
Things it won't do
- Change its own permissions: those change only with
tagmails starton the computer. - Act for anyone but you. Only the address you signed in with can start tasks, and replies go to you.
Set it up with Claude Code or Codex.