Practical guide

Give Codex an agent you can return to.

Murmello runs Codex as an agent with its own files and conversation. It sleeps when it has nothing to do, wakes where it left off, and every version of its work is saved, whether it runs in the cloud or on your Mac.

Updated October 13, 2026 · By Tomas Godoy Pastore

What you need

Install Murmello (download it, free) on an Apple silicon Mac running macOS 14 or later. Sign in to Murmello and have your Codex access ready: your ChatGPT login or an OpenAI key. Murmello’s cloud credits and your provider’s usage limits are separate.

1. Make a Codex profile

Connect Codex in Credentials, then make a Codex profile in Profiles with your instructions and model. Choose “Run commands: Ask” to approve commands yourself. If Codex can’t honour a setting, the profile says so.

2. Start the agent where it suits you

In Agents, choose New agent and pick the profile. Choose Cloud to keep it working while your Mac is closed, or This Mac to run it free in a folder you grant or in a copy Murmello keeps. From a terminal: murmello run <profile>, with --local for this Mac.

3. Work with it

Ask for a specific change with a test or build command to prove it. Codex shows each command it wants to run when you asked to approve them. Switch to Terminal to join the same live conversation in Codex’s own interface; an approval you answer there closes in the chat too.

4. Leave it

There is nothing to stop. After the idle time set in its profile, five minutes unless you change it, the agent sleeps; your next message wakes it with its conversation. Murmello saves a version of its work at the end of each reply, while it works, and before it sleeps: its files, each repository’s git history, Codex’s own history and the conversation. Caches and installed dependencies are left out and rebuilt when needed.

5. Come back later

Write to the agent and it carries on. A cloud agent asleep for 30 days is archived; Restore brings back its files and conversation and rebuilds installed packages. To try a different approach without losing this one, Fork… the agent and merge the fork back if it works out.

6. Bring the work home

Ask the agent to commit, then push the branch with GitHub…, or Move the agent to your Mac. If it runs in a folder on your Mac, its changes are already there.

When this setup fits

Use it when you want a Linux coding environment that keeps its work between sessions. Tasks that need macOS frameworks, Xcode or your Mac’s hardware still need a Mac environment: agents run Linux, in the cloud and on your Mac.

Murmello’s Needs you page: one agent waiting for your OK on a command, and two agents running.
Needs you gathers what is waiting for your answer. Shown with sample agents.

Next: setup and command reference · the Claude Code workflow.