Guides / Codex
Set up Tagmails with Codex
Email a task to Codex running on your own Mac or Linux computer. It works in the right project and replies in the same thread.
Before you start
- Codex installed and signed in with your ChatGPT plan. Run
codex login statusto check. - Node.js 20.16 or newer.
- A Gmail address to email from. Your first sign-in with Google creates the Tagmails account.
1. Paste one line into Codex
Read https://tagmails.com/skill.md and set up Tagmails.
Codex reads the setup skill, installs Tagmails, asks which agent and default model you want, and shows you a link. Open it, check that the page shows the same code, and continue with Google. It finishes by running tagmails doctor.
2. Add a balance and email your agent
Each reply costs $0.0025 (400 per $1); add $10 on the website. The model runs on your own ChatGPT plan. Write to your agent address and reply in the thread to continue the same Codex session.
What Codex can do
The default is Codex write: it reads your Mac, writes inside the chosen project and temp folders, and has network access so git push and gh work. Anything outside that goes to Codex's automatic reviewer instead of failing. Change the limit on the computer only:
tagmails start --access read # look, don't edit tagmails start --access write # the default tagmails start --access full # no sandbox, owner emails only
Models and effort
Set a default during setup or later with tagmails set --model gpt-6-sol --effort high. An email can override it in plain words ("use Luna on low") or with a first line like Model: gpt-6-luna. Fast mode is available where your plan offers it.
Which project?
Tagmails picks from your Codex projects and recent Claude Code folders using the name in your email, its purpose and recent work there. Without a clear match it runs in a fresh chat folder. To be exact: Work in /Users/you/code/site.
Containers and servers
Docker and RunPod usually block Codex's sandbox. tagmails start warns about it; use a VM, or --access full if you accept running without the sandbox.
If something is off
Run tagmails doctor first. If an email is waiting, the computer is probably asleep or the balance is empty. More in Support.
Next: what to email your agent.