Part 1: Understanding Codex
What Codex is
Codex is an agentic workspace: You give it a goal, and it plans the work, uses available tools and context, and produces a result for you to review. It can read and write files in the project folder you open, work with external services through plugins and apps, run multi-step workflows, generate code and scripts when a task needs them, and create documents, spreadsheets, presentations, PDFs, and websites.
Codex can:
- Work alongside you on multiple tasks in parallel
- Pull context from the apps and files you connect
- Use a supported browser and desktop workflows when a task needs on-screen action
- Check its work and iterate toward a defined goal when it has the context, tools, and permissions it needs
- Hold a persistent goal across a long-running session, instead of treating each message as a one-off request
- Turn repeatable tasks into recurring workflows
- Package reusable instructions as skills and installable plugins
- Turn plans, reports, and working material into hosted Sites
- Let you start, steer, and review work from your phone while Codex runs on a connected computer
These capabilities make Codex useful both for delegating well-specified tasks and as a shared workspace for human-agent collaboration. The central judgment call is deciding which mode fits the task.
The Only Subscription You Need to Stay at the Edge of AI
Start shipping agent-native products with Every.
Features to know
Five Codex features do most of the organizational work in this guide. They are easy to blur together, but each solves a different problem: Projects hold shared context, threads keep individual assignments separate, goals hold a longer objective, plugins add reusable capabilities, and Sites turn work into a shared interface.
Projects
A project gives Codex a particular folder and its instructions as the working context for one or more threads. Use one project for each ongoing area of work—a product launch, weekly reporting, recruiting—so its threads can draw from the same source material and rules. Keep durable decisions, current status, and source links in the project files rather than relying on any single conversation to remember them.
Threads
A thread is a conversation for one assignment or line of thought inside a project. Start a fresh thread when the assignment changes or a conversation becomes difficult to navigate. Long threads accumulate noise and Codex may compact them by summarizing relevant information. Project files preserve important information between conversations.
Separate threads do not automatically share their conversation history or report into one another. They can still coordinate through several mechanisms:
- Direct message: When thread-management tools are available, ask Codex to find a named thread and send it a follow-up prompt. Include the decision, source link, expected response, and where the receiving thread should put its result. The receiving thread learns only what the message and its own project context provide.
- Shared project files: One thread writes a brief, status update, or source map to the project; another reads that file. This is the most reliable way to pass information between threads because you can inspect exactly what was shared.
- Forking: Fork a thread when a new line of work should inherit the completed conversation history up to that point. The fork then develops independently.
- Subagents: Use subagents when one parent task divides into bounded pieces that should return to one synthesis. The parent can route follow-up instructions, wait for the results, and combine them.
- Automations: Attach a thread automation when the same conversation should wake on a schedule and continue an ongoing loop
A useful handoff prompt is: “Find the thread called [name]. Send it this update: [decision and source]. Ask it to [bounded task], save the result to [location], and report back when it is ready for review.” For consequential work, don’t assume the handoff worked; review the other thread or shared file.
Goals
A goal in Codex, initiated using the /goal command, is a persistent objective for a longer task. You tell it what “done” looks like, how success gets checked, and which constraints to respect. Codex works toward that outcome until it finishes, pauses, or needs your input. You can pause, resume, edit, or clear the goal as the work changes. If /goal is unavailable, you may need to enable the Goals feature.
Use /goal when an assignment has a clear destination but will take many steps. Standing instructions such as “cite every factual claim,” “match the house style,” or “never send without my review” belong in project files or a reusable skill instead.
Goals versus skills: A skill teaches Codex how to handle a recurring kind of task. A goal names what you are trying to accomplish in one longer stretch of work. When the objective is met, the goal is done.
Plugins
A plugin is an installable bundle of skills, apps, and MCP servers built around a reusable workflow. Browse the Codex plugin directory before building a common workflow from scratch. Use a local skill while the procedure is still changing; package a stable workflow as a plugin when you want to share it. Plugins are also useful when the workflow depends on bundled apps or MCP servers..
Installing a plugin does not give the plugin unlimited access. Its apps and MCP servers still depend on their own authentication, permissions, privacy rules, and workspace policies. Which plugins you can install can vary by plan, region, and workspace settings.
Sites
Sites turn plans, reports, dashboards, and other working material into hosted webpages or web apps. Use a Site when people need a shared workspace that remembers progress and supports recurring tasks. If they only need to read it, keep it as a document. A Site can remember progress when durable storage is configured.
Build the underlying workflow manually first. If a Site is justified, save a version for review before deploying it. Every deployment URL is a production deployment, so check the content, data handling, access settings, and audience before widening access. Sites can be limited to workspace admins, everyone in the workspace, or specific members and groups.
Codex on mobile
Codex mobile access lets you remotely control the Codex app on your host machine using the ChatGPT mobile app. The mobile app suits the lightweight parts of a workflow: You can kick off a task, answer a question, approve an action, or review a draft from anywhere. The connected host must remain awake, online, running the latest Codex app, and signed into the same account and workspace. Heavier review deserves a larger screen. See OpenAI’s remote connections guide for setup requirements.
What Codex isn’t
Codex needs supervision. It cannot replace taste, judgment, ownership, human review, or fact-checking. Avoid autonomous use when the source data is inaccessible, the criteria for success are entirely subjective, or an error would carry serious consequences.
Useful rules
A task is a good candidate for Codex if it has at least two of the following traits:
- It requires pulling data from multiple sources
- It involves repeated steps you do regularly
- It can be checked against objective criteria
- It produces a durable artifact—a document, a plan, a report, a script
- It benefits from synthesis across many inputs
- It’s annoying enough that you routinely delay or avoid it
Delegate tasks when they are:
- Repeatable
- Objective
- Easy to verify
- Low-risk
Collaborate on tasks that are:
- Ambiguous
- Judgment-heavy
- Exploratory
- Iterative
The Codex knowledge work loop
Every sustainable Codex workflow follows the same five-step pattern:
Connect → Contextualize → Delegate/collaborate → Review → Compound
Connect: Give Codex access to the systems you use for work—Gmail, Slack, Notion, Google Drive, your calendar, your analytics tools, your support platform, or local files. Without connected apps or source access, Codex is limited to the local and project files it can access, uploaded or linked materials, and context you provide in the thread. With connections, it can search the approved sources instead of relying on whatever you remember to paste into the prompt.
Contextualize: Put your goals, preferences, project details, source links, review standards, and standing rules in files Codex can access, then cite those files in Codex’s AGENTS.md file to make them readily available. This is the difference between an agent that has to be re-briefed every time and one that already understands who you are, what you’re working on, and how you like to work.
Delegate/collaborate: Decide whether the task needs close collaboration or can run on its own. Either way, specify inputs, output format, and acceptance criteria, then let it work.
Review: Check the output in the destination app. If Codex drafted Slack messages, review them in Slack. If it wrote a strategy document, review it in your word processor of choice, such as Google Docs, Notion, or Proof. Content that looks fine in a terminal or the Codex app may read differently in the space where it will ultimately be used.
Compound: Turn what works into something reusable. Save the prompt. Document the workflow. Add mistakes to your review checklist and keep your context files up to date. Each session should make future sessions faster.
Part 2: Setup
Connect your systems
Connect the tools you want Codex to have access to. This includes Gmail, Slack, Notion, Google Drive, your calendar, analytics tools, support platforms, or anything else for which Codex has an integration. Once the relevant tools are connected, Codex can look at your actual work context and suggest workflows based on your messages, files, meetings, and recurring tasks.
Connecting a tool isn’t the same thing as giving Codex unlimited permission to act using it. Start with the narrowest access that supports a real workflow. Require approval before Codex changes data in any connected tool. Plugins and apps remain subject to their own authentication, privacy, data-sharing, and workspace policies.
How Codex reaches your tools
Codex can touch the same tool in more than one way, and knowing which access path is which saves a lot of confusion:
- Local files give Codex direct access to material inside the project you opened
- Apps connect Codex to external services such as Slack, Gmail, Notion, and Google Drive
- Skills package reusable instructions, references, and sometimes scripts for a particular kind of task.
- MCP servers expose additional tools or shared information
- Plugins bundle skills, apps, and MCP servers into installable workflows
- Browser use operates local previews, file-backed pages, and allowed websites in the in-app browser. Signed-in sites require the Chrome extension or another authenticated surface.
- Computer use clicks and types inside desktop interfaces where available. Keep these tasks narrow because they can affect files and settings outside the project folder
The rule of thumb: Use the most structured path available. Start with local files or an app connection. Use browser or computer control only when the task truly depends on the interface.
Starting prompt—use this once your integrations are set up:
Connect to the tools I use for work: [List your tools—Gmail, Slack, Notion, Drive, etc.]. Then look at my work patterns across those tools and suggest three workflows I should set up first. For each one, describe the input sources, the output artifact, how often it should run, what approval looks like, and what would make the workflow worth keeping long-term.
Once your tools are connected, Codex can look at your actual work and suggest useful workflows. Repetition alone doesn’t mean a task should be automated.
Build your Codex workspace
Build Codex’s workspace before running any workflows. Skip this step and you’ll likely stall.
A Codex workspace is a folder—local on your machine, synced to GitHub if you want version control—that contains the instructions, context files, workflow documents, sources, and review standards Codex needs. Think of it as an onboarding manual and working file cabinet that both you and the agent can navigate.
Do not begin by designing the whole filing system yourself. Ask Codex to interview you first:
I want you to help me create a workspace for my knowledge work.
Interview me one question at a time about my role, responsibilities, active projects, recurring work, source systems, collaborators, output formats, working preferences, review standards, and safety boundaries.
When the interview is complete, summarize what you learned and propose a workspace structure that will be easy for both of us to navigate. Explain the purpose of each top-level file and folder. Do not create, move, rename, archive, or delete anything until I approve the plan.
If you already have a filing system, have Codex inspect it and propose the smallest useful set of additions. You do not need to move all of your work into a new “AI” folder. Keep the source of truth where it already lives and give Codex a clear map to it.
An example workspace structure
your-workspace/
├── README.md # Start here—orientation
├── identity/ # About you
│ ├── context.md
│ ├── preferences.md
│ └── rules.md
├── playbooks/ # Process—repeatable workflows
│ ├── workflows/
│ ├── inbox-sweep.md
│ └── research-brief.md
├── sources/ # Source shelf—inputs
│ ├── sources/
│ ├── key-links.md
│ └── recurring-docs.md
├── outputs/ # Finished work
│ ├── outputs/
│ ├── drafts/
│ └── reports/
└── reviews/ # Quality checks—guardrails
├── data-checklist.md
└── writing-checklist.mdWhat you’re doing here has a name: context engineering—arranging instructions and source material so Codex can find the right information at the right moment.
Codex reads AGENTS.md before it begins work. Keep the root file short: orient the agent, name the authoritative files, and state the rules that apply across the workspace. Put detailed or project-specific instructions in a nearer AGENTS.md inside the folder they govern. Codex combines the applicable files, with more specific instructions taking precedence.
Use supporting files only when they earn their keep. context.md can explain who you are and what you are working on; preferences.md can describe how you want work handled; rules.md can define approval boundaries; and STATUS.md can record current priorities and open decisions. A small workspace with current files beats an elaborate one that nobody maintains.
What to put in your context files
context.md should cover:
- Your role and the function you own
- Active projects and their current status
- The tools you use daily and what each one is for
- The people or teams you work with most closely
- How decisions typically get made in your context
preferences.md should cover:
- Writing style and tone (formal or conversational, terse or thorough)
- Communication preferences (what you like to review before it goes out and what can be drafted and queued without your involvement)
- Decision-making preferences (when to ask before acting and when to proceed and report back)
rules.md should cover:
- What Codex may never do without explicit approval: send, post, archive, delete, modify a source of truth, or move money
- What Codex may do without asking: draft, summarize, research, outline, organize
- Any standing constraints specific to your work (e.g., client confidentiality rules, brand standards, data handling requirements)
Starting prompt—use this to have Codex create your workspace structure:
Set up this folder as a simple Codex workspace for knowledge work. Start with a short root AGENTS.md that explains what this workspace is for, which files are authoritative, how to verify important work, and which actions require my approval. Create only the supporting context, preference, status, source-map, workflow, and review files the approved plan requires.
Before you finish, test the setup by explaining my role, current priorities, sources of truth, and approval rules back to me. Flag anything that is missing, contradictory, or hard to find.
Part 3: The five levels of Codex use
Codex power users don’t arrive there all at once. They get there in stages, and each stage calls for a different way of thinking about what Codex is doing and what it’s good for. Skip ahead too quickly, and you’ll get frustrated—either you don’t trust it yet, or you haven’t built the infrastructure for more autonomous work. At every level, you should know when to hand work to Codex and when to stay in the loop as its collaborator.
Treat these levels as a ladder of complexity, not status. Levels 1 and 2 are a sensible beginner range, Level 3 is intermediate, and Levels 4 and 5 are advanced. An experienced operator may still keep high-stakes work at Level 1 because close review is the correct design.
Level 1: One-off knowledge work
Mental model: Codex as a capable, thorough research and drafting assistant.
Mode: Collaborate. At this level, nothing is automated. You run single-session tasks, review everything before it leaves your hands, and build familiarity with how Codex handles different types of work.
Best first tasks:
- Summarize a meeting transcript and extract decisions, open questions, and follow-up actions.
- Turn scattered notes into a structured outline.
- Build a research brief from a set of links and documents.
- Rewrite a draft against a style guide.
- Create a review checklist for a document, launch plan, or strategy memo.
- Convert a written draft into an audio file for editing on the go.
Prompt pattern:
Use the attached [documents/links/notes] to produce [specific artifact]. Prioritize accuracy over elegance. Include source links for any factual claims. Flag anything uncertain or that requires my verification. End with the three questions I should answer before this artifact is ready to use.
Review habit: Before polishing any output, ask Codex to list the assumptions it made and where it is least confident. This surfaces problems before you invest time in refinement.
Move to Level 2 when: You keep wishing Codex remembered what you told it last time.
Level 2: Multi-source workflows
Mental model: Codex as a cross-system analyst that can assemble information you could never pull together manually in a reasonable amount of time.
Mode: Collaborate. At this level, Codex can synthesize outputs from multiple connected systems—Slack threads, Notion pages, email archives, analytics dashboards, and Google Drive documents—but it still needs guidance and feedback.
Example multi-source tasks:
- A go-to-market plan built from internal meeting transcripts, Slack discussions, customer notes, and a strategy template
- A weekly KPI report from analytics, revenue data, support volume, and social metrics
- A summary synthesized from Slack, Notion, Drive links, and past drafts
- A weekly leadership brief assembled from team standups, metrics, and open decisions
How to delegate a multi-source task:
I need [specific artifact].
Sources to use:
- [Tool 1]: [what to look for there]
- [Tool 2]: [what to look for there]
- [Tool 3]: [what to look for there]
Output format: [describe the structure you want]
Before you start, give me a short plan: Identify the sources you will inspect, the artifact you will produce, any gaps or unknowns you anticipate, and the checks you will run before calling it done. If anything requires sending, posting, archiving, or modifying a source of truth, ask first.
A warning about data: A one-shot attempt at pulling data from multiple systems can be wrong because of stale data, mismatched definitions, permissions gaps, or join errors. For any metric that informs business decisions or agent actions, verify column by column against your primary source. The closer a number is to a source of truth, the more carefully it needs to be checked.
Make your outputs agent-readable: Plans and reports you generate in Codex will be read by other people—but also, increasingly, by their agents. Write them in plain, structured language that a human can scan and an agent can query. Clear section headers, explicit decisions, and labeled action items make the artifact useful in both directions.
Move to Level 3 when: You keep running the same multi-source workflow more than once a week and wishing it happened automatically.
Level 3: Recurring workflows
Mental model: Codex as an automated operations layer that handles predictable, recurring work so you don’t have to.
Mode: Hybrid. Some tasks are fully predictable and can run without back-and-forth. These tasks are ripe for delegation. Tasks that involve judgment, strategy, or creative decisions suit collaboration.
A useful heuristic: If a checklist covers most cases, delegate the execution. If you need to think about the task differently each time, collaborate.
In either case, look for “computer chores”—recurring tasks that take time and attention, but don’t require human judgment at every single touchpoint.
Common chore candidates:
- End-of-day check for unanswered Slack messages and emails, with drafted replies
- Weekly metrics brief from analytics, revenue, and support data
- Meeting-note cleanup and action-item extraction after each recorded call
- Customer support pattern detection and issue routing
- Draft-to-review package that formats a piece for editor handoff
- Recruiting research for an open role
The workflow:
Before building any persistent workflow, fill out this template. Save it as the instruction file Codex should read each time you run the workflow. (The workflows in Part 4 are each an example of this canvas applied.)
Workflow name:
Trigger or cadence:
Input sources:
Output artifact:
Approval rules:
What Codex may do without asking:
What Codex must ask before doing:
Verification steps:
Where the final output lives:
When to retire or revise this workflow:
Review discipline for automated workflows: Don’t review automated output only inside Codex. Review in the destination app—Slack for Slack messages, Gmail for email drafts, and a word processor for documents. The output may look different in the tool where it will be used, and the change of context often reveals problems.
Move to Level 4 when: Your prompt-based workflow hits a ceiling—the task is too complex or too custom to handle in text alone, and a small script or local tool would make it reliable.
Level 4: Custom tools
Mental model: Codex as a builder that creates lightweight infrastructure to make your workflows more reliable, faster, or more repeatable.
Sometimes the best Codex output is a small script, a local app, a custom dashboard, or a review surface that makes a recurring workflow easier, rather than pure text.
Mode: Hybrid. In some cases, Codex may generate an artifact independently for you to review and then move on. In others, the artifact it produces may become a space where you and the agent iterate together.
Examples of when a small tool helps:
- A recurring workflow that requires pulling from an API that has no Codex integration. A short script handles the connection reliably.
- A review process where you need to see formatted output side by side with the source. A simple local app gives you the view.
- A task that needs to run on a schedule. A Codex automation can handle it after you test the prompt manually and define permissions, review, and failure behavior.
- A workflow that accumulates structured data over time. A lightweight database or structured file tracks it persistently.
- A report or review queue that has outgrown a document. A Site can give people a shared place to view the work, while a small app can remember progress and let people approve or reject items.
Practical approach for non-engineers:
- Run the task manually in Codex once to confirm the output is what you want
- Ask Codex: “Which steps in this workflow could be made more reliable with a small script or tool?”
- Have Codex prototype the tool and explain what it does in plain language
- Run it on your data and verify the output matches what the manual process produced
- Keep only the parts that reduce friction. Discard what adds complexity without benefit.
You don’t need to understand every line of code to use a tool Codex built. You should be able to explain what goes in, what comes out, and where a person checks the result. If you can’t, the tool isn’t ready to run autonomously.
Prefer a document or spreadsheet when it can do the job. If you use Sites, ask Codex to save a version for review before deploying it: Every deployment URL is a production deployment. Check content, data handling, access settings, and audience before widening access.
Move to level 5 when: You give Codex the same feedback repeatedly and have standing preferences that you’d prefer it to apply on its own.
Level 5: A compounding system
Mental model: Codex as a system that can improve over time when you save useful workflows, maintain review rules, and use memories or skills to codify preferences where available.
Mode: Hybrid. Some instructions will dictate how the agent approaches autonomous work; others will guide how the model interacts with you in collaboration mode.
The idea of “compounding” work comes from compound engineering, the AI-native coding methodology coined by Kieran Klaassen and Nityesh Agarwal while building Cora, Every’s email client. The canonical example is a product requirements document (PRD) that writes the scaffolding for the next one: The artifact you produce becomes the tool that speeds up the next round. The four habits below are how you put it into practice as a knowledge worker, not just an engineer.
Each useful session should make future sessions faster and more reliable. In practice, that requires doing four things consistently after completing any significant piece of work:
- Save successful prompts as workflow files. When a prompt produces exactly the right output, document it. Write down the input sources, the exact prompt, the output format, and the review step. Save it in your workflows/ folder. The next time you need the same output, the agent will have that reference to work from.
- Add mistakes to review checklists. When Codex gets something wrong—a number that was off, a tone that missed the mark, or an assumption it should not have made—add a specific check to your relevant review file, and instruct Codex to check its work against those guardrails.
- Update your context files after major projects. When a project ends, update context.md to reflect what changed—new priorities, new tools, what worked, and what didn’t. Codex can use the pattern when you point it to the file or turn it into a reusable skill or workflow.
- Ask Codex to identify compounding opportunities. At the end of any session where you did something useful, run this prompt:
Based on what we just did, what parts of this workflow should become a reusable skill, an automation, or a small tool? What context should I add to my project files so we don’t have to re-establish this next time?
When a workflow becomes stable enough to share, package it only if the plugin directory does not already cover it. Every’s compound engineering guide shows how a maintained plugin can package a complete working method rather than a single prompt.
Part 4: Workflow library
These workflows are meant as inspiration to get you started. Adapt the inputs, outputs, and approval rules to your specific tools and standards.
Choose the lowest-complexity workflow that solves the job. We’ve tested the additional examples at Every and adapted them so they don’t depend on our private systems. For more of the operating context behind the original library, read “One App to Rule All Knowledge Work” and “The Dawn of Codex-native Apps”.
1. Inbox zero review queue
Best for: Anyone whose email backlog is a recurring source of anxiety or dropped balls.
Input sources: Gmail or your email client of choice.
Output artifact: A structured list of draft replies, proposed actions (archive, delegate, flag), and any emails flagged for your personal attention because the draft alone isn’t sufficient.
Dan Shipper kept inbox zero for 10 days straight with Codex. To use this workflow, have Codex:
- Gather email through Cora running in the in-app browser.
- Render the email queue as a single page.
- Go through each item with you as you dictate the action the AI should take (e.g., “research this,” “draft that,” “pull the documents our lawyers asked for.”) You can do this via chat or voice with a dictation tool like Monologue (we recommend the latter).
First prompt:
Go through my inbox for the past [time period].
For each email that needs a response or action:
- Categorize it: needs reply/needs action/can archive/already handled
- If it needs a reply, draft one in my voice using the style in preferences.md
- If it needs action, describe the action clearly
- Flag any email where a draft reply isn’t enough—where I need to think about this personally before responding
Don’t send anything. Create drafts only. I will review in Gmail.
Review step: Review all drafts in Gmail before sending. Don’t approve from inside Codex.
How to compound: After a few sessions, add a rule file describing your categorization preferences—which senders always get priority, which topics can be archived without reply, and which types of requests need a human-written response.
2. Daily unanswered message roundup
Best for: Anyone who communicates across Slack, email, and other channels and loses track of what still needs a response.
Input sources: Slack, Gmail, any other communication tool you use.
Output artifact: A list of unanswered items with drafted replies or proposed reactions, organized by urgency.
First prompt:
Look across my Slack and Gmail for the past 24 hours. Find everything that was directed at me that I have not responded to.
For each item:
- Draft a reply or suggest a reaction (thumbs up, etc.) if a short acknowledgment is appropriate
- Flag items where a more considered response is needed
- Flag anything time-sensitive
Present the list organized by urgency. Don’t send anything.
Review step: Review in Slack and Gmail.
How to compound: After a few runs, save a rules file specifying which Slack channels are high-priority, which senders always warrant a human response, and which types of messages can be handled with a reaction rather than a reply.
3. Research brief
Best for: Anyone preparing for a meeting, a pitch, a content piece, or a strategic decision and needing a thorough, sourced summary of a topic.
Input sources: Provided links, Notion, Drive, web search.
Output artifact: A structured brief with background, key facts, open questions, and source links.
First prompt:
Build a research brief on [topic].
Sources to prioritize: [List any specific links, documents, or databases].
Structure the brief as:
- Background: what I need to know to have a smart conversation about this
- Key facts and data points, each with a source link
- Competing perspectives or significant disagreements in the field
- Open questions I should be able to answer before [meeting/decision/deadline]
- Three things I should read next if I want to go deeper
Flag any claims you are less than confident about.
Review step: Check source links. Verify any statistics against the original source before using them.
How to compound: Save a brief template in your workflows/ folder. After each brief, add any recurring sources (newsletters, databases, key authors) to your sources/key-links.md so Codex checks them by default.
4. Writing review loop
Best for: Writers who want Codex running alongside them as they draft—checking the work, flagging issues, and responding in parallel without interrupting the writing session.
Input sources: Your draft as a file or in a supported review surface, plus any relevant style guides, source documents, or review standards in your workspace.
Output artifact: An annotated draft with inline feedback, flagged issues, and suggested revisions—produced continuously as you write rather than in a single pass at the end.
Setup:
Open your draft in Proof or make it available as a file in the project. Start a Codex session with your workspace context loaded. Give Codex standing instructions for what to monitor and how to respond.
First prompt:
I am writing [describe the piece—type, audience, purpose].
As I draft, run a continuous review loop. Check for:
- Claims that need a source or are stated with more confidence than the evidence supports
- Passages where the argument loses clarity or the logic has a gap
- Sentences that violate the style preferences in preferences.md
- Anything that reads as filler, throat-clearing, or AI-generated phrasing
Don’t rewrite anything without being asked. Flag issues as I go with a brief note on what the problem is and what would fix it. Check in every [X minutes / X paragraphs] or when I ask.
Review step: Read the flagged issues at natural stopping points—the end of a section or session. Decide which to address and which to dismiss. Don’t let the feedback loop interrupt the drafting flow; the value is in the accumulation, not in responding to every flag in real time.
How to compound: After each writing session, add any recurring flags to reviews/writing-checklist.md. Patterns that come up repeatedly are candidates for a standing rule in your preferences file, so Codex checks for them next time.
5. Source management for research
Best for: Writers and researchers who need to organize source material before drafting.
Input sources: Links, PDFs, past drafts, notes, transcripts.
Output artifact: A structured document with the core argument, supporting evidence organized by claim, counterarguments, and a gap analysis (what is still missing).
First prompt:
I am writing a piece on [topic]. The core argument I want to make is [argument].
Here are my source materials: [links/documents].
Build an evidence room that:
- States the core argument clearly
- Lists the strongest supporting evidence for each main point, with source links
- Lists the strongest counterarguments and how I might address them
- Identifies any gaps—claims I am making that lack strong evidence
- Flags any sources that conflict with each other
Review step: Read the evidence room before drafting. Verify any statistics or quotes you plan to use directly.
How to compound: Save the evidence format as a workflow template. Add a standing note to your context file about your writing voice and recurring themes so Codex calibrates its framing.
6. Audio briefing
Best for: Anyone who processes information better by listening than reading, or who wants to take time away from a screen but stay on top of work.
Input sources: Any written content: drafts, research briefs, meeting summaries, strategy documents, reports, lengthy emails, articles.
Output artifact: An audio file saved to a location accessible from your phone (Dropbox, Drive, etc.).
First prompt:
Convert the attached [document/draft/report] into a clear audio file. Read it at a natural pace—not rushed, not slow. Save it to [Dropbox/Drive location] as [filename].
Review step: Listen on your commute, walk, or wherever you have time away from a screen. Take notes on your phone as things come up. Return to the source material with whatever you noticed.
How to compound: Add a standing instruction to your context file covering your audio preferences—such as speed, file format, naming convention, and preferred save location—so you do not have to specify each time. You can also prompt Codex to convert content automatically at the end of certain workflows: “After generating the weekly metrics report, convert it to audio and save to [location].”
7. Go-to-market plan
Best for: Anyone responsible for launching a product, feature, or initiative and who has done the thinking in meetings and Slack but has not had time to formalize it.
Input sources: Meeting transcripts, Slack threads, customer notes, a preferred strategy template.
Output artifact: A complete go-to-market plan, structured for human review and agent querying.
First prompt:
Build a go-to-market plan for [product/initiative].
Sources to pull from:
- Meeting transcripts: [Notion location or links]
- Slack discussions: [channels or search terms]
- Customer research: [document or location]
- Template to follow: [link or paste template]
The plan should be readable by a human in five minutes and structured so that an agent can answer specific questions about it (e.g., “What is the target ICP?” “What is the launch timeline?”).
Start with a compound engineering brainstorm step. Give me a draft in Proof or Notion. Flag anything in the plan you added that was not in the source material—I only want synthesis of what we have already decided, not new suggestions baked in.
Review step: Review in Notion or Proof. Verify that every major claim traces to something in the source material. Anything the model added that was not in your sources should be flagged for your decision.
How to compound: Save the template and the prompt. After each launch, add a retrospective note to your context file about what the plan got right and wrong. Future plans will be calibrated by past ones.
8. KPI report
Best for: Anyone responsible for tracking metrics and needing a regular, reliable view across multiple data sources.
Input sources: Analytics (PostHog, Mixpanel, Amplitude), revenue data (Stripe), support volume, social metrics, saved past reports.
Output artifact: A one-page report covering headlines, usage metrics, system health, and follow-up items.
First prompt:
Generate a product pulse report for [time period].
Data sources:
- Product analytics: [tool and what to pull]
- Revenue: [tool and what to pull]
- Support: [tool and what to pull]
- Social: [tool and what to pull]
Structure:
- Headlines (three to five bullets summarizing what matters most)
- Usage (primary engagement metric, value-realization metric, conversions, deltas vs. prior period)
- System health (error rates, latency, top error signatures)
- Follow-ups (one to five things worth investigating, specific enough to act on)
Flag any number that differs significantly from the prior report. If something is anomalous, investigate one level deeper before including it.
Review step: Verify every number in the report against its source. Don’t use this report as a business source of truth until you have confirmed accuracy column by column. Different definitions and incorrectly matched records can make a report look right when it isn’t.
How to compound: Save each report as a dated file in your outputs/reports/ folder. Over time, Codex can compare reports, identify trends, and flag when something has changed. The folder becomes the working memory of your product.
9. Customer support issue queue
Best for: Teams where support patterns should feed into product decisions and small fixes.
Input sources: Support platform (Intercom, Zendesk), issue tracker (Linear, GitHub Issues).
Output artifact: A deduplicated list of issues with suggested priority, plus small issues ready to hand off for fixes.
First prompt:
Go through my support queue for the past [time period].
For each support thread:
- Identify the underlying issue or request.
- Check whether a similar issue already exists in [Linear/GitHub Issues].
- If it does, link them. If it doesn’t, draft a new issue.
- Flag any issue that appears more than [threshold] times—these are priorities.
- For issues that appear straightforward to fix, note that they are candidates for direct implementation.
Don’t create issues in the tracker yet. Give me the list to review first.
Review step: Review the issue list before anything goes into the tracker. Confirm deduplication is accurate—support tickets often describe the same underlying problem in different words.
How to compound: After each session, add a note about recurring issue types so Codex can categorize faster next time. Build a persistent list of known issues so deduplication improves over time.
10. Pull requests for non-engineers
Best for: Anyone who needs to make a small, well-scoped change to a codebase—such as copy updates, configuration changes, or content edits—without deep engineering knowledge.
Input sources: The relevant files or repository, and a clear description of the change.
Output artifact: A pull request (PR) that is reviewer-friendly and doesn’t touch anything outside the intended scope.
First prompt:
I need to make the following change: [describe the change clearly].
Before making any changes:
- Show me which files are affected
- Confirm the scope of the change—nothing outside these files should be touched
- Explain what you are going to do in plain language before doing it
After making the change:
- Summarize what was changed and why
- List every file that was touched
- Explain how you verified the change is correct
- Flag anything a reviewer should look at carefully
Make the smallest useful change. Don’t refactor or improve anything adjacent.
Review step: Review the Codex preview before the PR is opened. Review the PR itself in GitHub or your code review tool. Ask a technical colleague to approve before merging if you are uncertain.
How to compound: Save a template of your preferred PR format. After each PR, add a note about anything that requires correction so future PRs avoid the same issue.
11. Recruitment shortlist
Best for: Anyone doing outbound recruiting for a role with a specific background profile.
Input sources: LinkedIn, Twitter/X, company websites, alumni databases, public professional networks.
Output artifact: A list of candidates with background summaries and contact information or connection points.
First prompt:
I am hiring for [role]. The ideal candidate has [background profile—experience, prior companies, skills, career trajectory].
Search for candidates who match this profile. For each candidate:
- Summarize their background in two to three sentences
- Note why they match the profile
- Identify any connection point (mutual connections, follows, shared affiliations)
- Provide a link to their public profile
Return the top [number] candidates, ranked by how closely they match the profile.
Review step: Review each candidate before any outreach. Verify that the background summaries are accurate by checking the linked profiles. Don’t send any outreach through Codex.
How to compound: Save the role profile as a template. After a successful hire, document what the actual background looked like versus the initial profile to calibrate future searches.
12. Strategic plan
Best for: Leaders and operators who need to compress OKR planning, quarterly planning, or strategic reviews from days to hours.
Input sources: Past planning documents, meeting transcripts, leadership context notes, relevant metrics.
Output artifact: A draft plan or OKR set, structured for review and iteration.
First prompt:
I need to draft [quarterly plan / OKR set / strategic review] for [scope].
Pull from:
- Past plans: [location]
- Recent meeting transcripts: [location]
- Current metrics: [location or description]
- Leadership context: [document or description]
Structure the output as [desired format].
Flag any goal or initiative you are recommending that doesn’t have explicit support in the source material. I want synthesis of what has already been decided, not new recommendations baked in without my review.
Review step: Review in Notion or Proof. Before sharing with leadership or the team, confirm that every major commitment traces to a decision that was actually made.
How to compound: After each planning cycle, add a retrospective to your context file. Did the goals prove achievable? What was missing from the original plan? Future planning sessions will be informed by past ones.
13. Personal learning tool
Best for: Anyone who wants to use Codex to support skill-building, practice, or self-directed learning.
Input sources: External APIs, files, structured practice materials, your own notes.
Output artifact: A custom interactive tool—like a tutor, a quiz, or a practice environment—built for your learning goal.
Example:
A musician wants to practice chord identification. They connect a MIDI keyboard and describe what they want, and Codex builds a small app that listens to what they play, identifies the chord, and tracks progress over time.
First prompt:
I want to build a personal learning tool for [skill or subject].
My current level: [beginner/intermediate/what I know already].
What I want to practice: [specific aspect of the skill].
How I want feedback: [immediate/after each session/scored].
Build a prototype I can use locally. Explain what it does and how to use it before I start.
Review step: Try the tool on real practice material before committing to it. Verify it is actually testing what you intended.
How to compound: After each practice session, ask Codex to update the tool based on what you found most and least useful. The tool improves as your needs become clearer.
14. Living idea bank
Best for: Editorial planning, product ideas, customer requests, research leads, or any area where useful signals arrive gradually.
Input sources: Approved channels and documents, public sources, existing coverage, and a scoring rubric.
Output artifact: A maintained backlog with evidence, status, duplicates, and a smallest next action.
First prompt:
Create an idea bank for [domain]. For each candidate, record the problem or opportunity, source links, what already exists, why the idea would help the audience, its status, and the smallest next action.
Compare every candidate with the existing bank before adding it. Do not promote an item based on one weak signal. Preserve rejected ideas and the reason for rejection.
Review step: Check source quality, duplicate ideas, and criteria changing over time. A scan that finds nothing useful should say so rather than padding the bank.
How to compound: Run collection manually first. Turn it into a skill or scheduled scan only after the data fields, qualification rules, and review process hold up..
15. Shared review Site
Best for: Reports, roadmaps, source rooms, dashboards, and review queues that have become awkward to operate as documents.
Input sources: A proven manual workflow, the current artifact and source data, intended users, required actions, access rules, and an owner.
Output artifact: A saved Site version for review, followed by a deployment only after approval.
First prompt:
Compare keeping this work as a document, moving it to a spreadsheet, and creating a Site. Base the recommendation on who will use it, what they need to see or do, what state it must remember, how often the information changes, and who will maintain it.
If a Site is justified, build and save a review version. Do not deploy it until I approve the content, data handling, access mode, and audience.
Review step: Test it with real data and a real task. Check the source changes, stored data, access settings, and selected saved version before deployment.
How to compound: Add controls only when they support a repeated action. Record ownership, data sources, failure behavior, and a plan for when to retire the Site.
16. Content update queue
Best for: Public pages, knowledge bases, recurring reports, or resource lists that need regular updates but should never change automatically.
Input sources: The current artifact, approved sources, clear rules for what warrants a change, and a dated record of past decisions.
Output artifact: A list of suggested changes and supporting evidence.
First prompt:
Review [artifact] against [approved sources] for changes worth considering. For each recommendation, show the current material, the proposed change, the supporting evidence, and why the update clears the rubric.
Do not edit or publish anything. Put every recommendation in a review queue. If nothing is worth changing, report that clearly.
Review step: Accept or reject each proposal in the artifact’s intended destination. Verify links, dates, claims, and rendered appearance before publication.
How to compound: Record what you accept and reject. The system can learn from these choices, but it should never publish without approval.
Part 5: Operating Codex well
How to Steer Codex
Operating Codex well is management work. You evaluate talent (which prompts, agents, and workflows to trust), set vision (what to point Codex at, and what “done” should look like), exercise taste (catching output that is technically correct but wrong for the moment), and know when to let be or take the wheel.
Give Codex an outcome. Describe what you want to end up with, not how to get there. “Build a research brief on [topic] with these sources and this structure” produces better results than “First search Slack, then search Notion, then...”
Ask for a plan before long-running work. For any task that will take more than a few minutes or touch multiple systems, ask Codex to explain what it’s about to do before it starts. This catches misunderstandings early and gives you a chance to redirect it before it gets too far along.
Ask Codex what it needs before it starts. For complex tasks, a short briefing prompt saves time:
Before you start, tell me what additional context would help you do this better. What are the most important things you would want to know?
Require citations and audit trails for important claims. Any document that will be shared or used for decisions should have source links for factual claims. Make this a standing rule in your preferences file.
Don’t micro-manage every step once the plan is sound. Interrupt when the approach is wrong, the assumptions have changed, or Codex reaches a boundary you did not approve. Otherwise, let it complete a coherent pass before you review.
Review in the destination app. Always.
Set explicit no-send, no-post, no-archive, and no-modify rules in your rules file. These should apply by default to any sensitive workflow. Make Codex ask before taking any action that can’t easily be undone.
Three questions to ask before approving any significant output:
What was the hardest decision you made in producing this?
What alternatives did you consider and reject?
Where are you least confident?
These questions surface the judgment calls the model made, the options it dismissed, and the places most likely to contain errors.
Safety, trust, and risks
Common failure modes and how to handle them:
Confident wrongness. Codex can state incorrect facts with high confidence. For any factual claim that matters, verify against the source. Never pass a statistic or claim to another person without checking it.
Metrics errors. Joining data from multiple sources introduces definition mismatches and calculation errors. Verify column by column for any metric used in decisions.
Out-of-scope changes. Codex sometimes modifies files or makes improvements adjacent to the task you assigned. Review the changes line by line (called a “diff”), not just the final output, especially for any task involving code.
Broken automations. Persistent workflows stop working when tools update their APIs, credentials expire, or context files become stale. Every automation needs an owner who checks it periodically. “Set it and forget it” isn’t a stable operating mode.
Plugin and integration failure. Plugins and integrations need maintenance: Permissions expire, APIs change, configurations need updates, and some changes require restarting Codex or beginning a new thread. If a workflow produces strange output, check whether every expected connection is still working before assuming the prompt is wrong.
Usage limits. Long-running sessions can hit usage limits and stop mid-task. For complex workflows, break work into stages rather than attempting everything in a single session.
Untrusted input. Anything Codex reads—an email, a web page, a shared document, a support ticket—can contain instructions aimed at the agent rather than at you, sometimes hidden from human eyes. If Codex is browsing untrusted sites or processing external messages while holding broad write access, those buried instructions can turn into actions—like sending data where it shouldn’t go. So keep destructive actions behind approval, and scope each workflow to the least access it needs, so a hijacked instruction has nowhere to go.
The human ownership standard: Codex can touch any artifact in your workflow, but a human must direct the work, stand behind the output, and be able to discuss any specific decision in it. If someone asks you about a bullet point in a document Codex drafted, you should be able to answer. An AI-drafted document is fine—expected, even—but if someone talks it through with you and it’s clear you have no idea what’s in it, that’s a problem.
Team workflows: From personal Codex to shared operating system
Individual Codex workflows compound over time. Team workflows compound faster but require coordination.
What changes when a team uses Codex
Teams build trust in agents through the humans who operate them. When a colleague receives a document or plan that Codex drafted, they trust it to the degree they trust the person who shared it.
Infrastructure that makes team Codex work
Shared review surfaces. A shared document review tool (Proof, Notion, Google Docs) makes agent-generated documents easier to inspect and comment on than outputs reviewed only inside Codex.
Explicit handoffs. Subagents report back to the task that created them, and scheduled thread work stays in its own conversation. Separate threads do not share updates automatically. When one thread needs another’s work, send a clear handoff and save the result in a shared file or review tool. Give each workflow an owner and approval rules.
Shared skills and plugins. A maintained skill can package a team’s review standards; a plugin can distribute a workflow together with the apps or MCP connections it needs. Teams should inspect those dependencies and permissions before asking everyone to install the same setup.
Shared, agent-readable documentation. Plans, strategy documents, and operational guides written for both human and agent readers become shared infrastructure. Any team member—or any team member’s agent—can query them for specific information without interrupting the author.
Explicit ownership. Every persistent workflow needs a named owner. That person is responsible for monitoring output quality, updating the workflow when it breaks, and retiring it when it’s no longer useful. Automation degrades without ownership.
A simple way to get a team to use Codex
Don’t try to convert everyone at once. Start with one recognizable problem for one role. Show the artifact, the review step, and what the human still owns. Three things, done together, help a useful workflow travel:
- A note from a leader that makes using AI the expectation, not a nice-to-have
- A weekly meeting where anyone can show a prompt or workflow they’ve built
- A regular message that names the people whose work stood out
Set the expectation, give people a place to share what works, and recognize them for it—that’s most of the battle.
Part 6: Getting started
The seven-day Codex power-user plan
Day 1: Connect and inspect. Install the Codex desktop app and open one folder you are comfortable using as a project. Connect one or two sources that support a real job you already do. Run the workflow-discovery prompt from Part 2. Don’t build or automate anything yet.
Day 2: Let Codex interview you. Have it propose the workspace structure and a short root AGENTS.md, plus only the supporting context, preference, status, source-map, workflow, and review files you need. Approve the plan before it changes the folder.
Day 3: Run three one-off tasks. Choose one summary task, one research brief, and one draft or plan. Use the prompt patterns from Level 1. Review each output carefully and note where Codex got things right and where it needed correction.
Day 4: Build your first repeatable workflow. Take the most useful task from Day 3 and fill out the workflow canvas from Level 3. Save it to workflows/ in your workspace. Run it again with different inputs and verify the output before you consider scheduling it.
Day 5: Add review rules. Create reviews/data-checklist.md, reviews/writing-checklist.md, and reviews/comms-checklist.md. Start each one with five checks based on what you noticed during Days 3 and 4. These will grow over time.
Day 6: Turn one workflow into a reusable artifact. Document the prompt, inputs, output format, review step, and known edge cases. Keep it as a workflow file while the process is changing; turn it into a skill when the procedure is stable enough to reuse. Browse the plugin directory before packaging a common workflow from scratch.
Day 7: Compound. Run the compounding prompt at the end of your Codex session:
Based on everything we have done this week, what should become a reusable skill, an automation, or a small tool? What context should I add to my project files so future sessions start from a better baseline?
Review Codex’s suggestions and implement the one that would save the most time over the next month.
30-day extension
- Week 1: One personal workflow running reliably
- Week 2: One multi-source workflow pulling from at least three connected tools
- Week 3: One stable process packaged as a workflow or skill, with a clear review rule
- Week 4: One advanced capability only if the work justifies it: a Site, plugin, small tool, or automation
Start today: Open one safe folder in Codex. Choose one job you already know how to do. Give the agent the sources, define the artifact, and tell it how you will check the work. Run it well once; let the rest grow from there.
Katie Parrott is a staff writer at Every. You can read more of her work in her newsletter.