Interactive workflow chooser · official docs checked Nov 3, 2026
Choose a local, cloud, or CI coding-agent workflow
Choose a coding-agent workflow from your hard requirements: local files and tools, close interactive control, async handoff, or repeatable CI automation.
How do I choose between a local, cloud, or CI coding agent?
Start with a hard constraint. If the task needs files, tools, or services available only on your machine or private network, choose an environment that can reach them, such as a local session or a suitably configured self-hosted runner. Otherwise, choose local for close interactive steering, cloud for a well-scoped handoff you will review later, or CI when a defined event or schedule should run the same bounded task with preset permissions and credentials. The interactive chooser below applies this method; these are workflow patterns, not interchangeable product guarantees.
What does the chooser use to make its recommendation?
It asks whether the task depends on machine-local resources, then asks how the work should run: interactively with you, asynchronously with a reviewable change, or automatically from a repeatable trigger. A local-resource requirement takes priority because a cloud or hosted runner may not be able to reach that resource. If multiple requirements conflict, use the recommendation as a starting point and validate the actual host and access path with a small task.
Which official documentation supports these workflow choices?
OpenAI documents Codex CLI for interactive project work and `codex exec` for scripts and CI with explicit sandbox and approval settings. GitHub documents cloud agents as asynchronous task delegation that can create a pull request for review, and automated workflows as event- or schedule-triggered tasks. These examples establish workflow boundaries; they do not show that all products expose the same features or controls. Documentation checked November 3, 2026.
How should I validate the selected workflow?
Use a disposable branch and a small task with one harmless file change and a known validation command. Record the agent and version, where it ran, which files and services it could access, how credentials were supplied, what checks ran, and whether the result can be reviewed before merge. Inspect the diff and run the checks yourself. This tests fit with your repository; it does not measure general coding quality or security.
Sources
- OpenAI Codex CLI documentation · interactive and repeatable CLI workflows · checked Nov 3, 2026
- OpenAI Codex non-interactive mode · `codex exec` for scripts and CI · checked Nov 3, 2026
- GitHub Docs: About GitHub Copilot agents · local, cloud, and automated workflow distinctions · checked Nov 3, 2026
- GitHub Docs: Third-party coding agents · asynchronous tasks and pull-request review · checked Nov 3, 2026