Documentation
Your first cloud workspace.
Murmello is a native Mac terminal for running Claude Code, Codex and shell commands in cloud workspaces. Each workspace is a remote Linux computer, also called a pod.
1. Install and sign in
Download the Mac app, open the DMG and drag Murmello to Applications. You need macOS 14 or later and an Apple silicon Mac. Open the app and sign in to use cloud features. Local terminal work stays on your Mac.
The first-run tour introduces the Cloud, Files, Keys and Dictation controls in the titlebar. Replay it from Help → Show the Murmello Tour.
2. Start a workspace
Open Cloud in the titlebar, choose New pod, then Claude Code, Codex or a shell. You can also run one of these commands in a local Murmello terminal:
murmello cloud --claude
murmello cloud --codex
murmello cloudRun only the command for the workspace you want. The first start may take a few minutes. Sign in to your agent inside the workspace; its installation and account setup are shared with your other workspaces. Agent access is separate from your Murmello plan.
3. Bring your project
You can clone a repository inside the cloud workspace using Git, or send a local repository with Murmello. For a private GitHub repository, add a suitable GitHub token through Keys in the titlebar.
To send a local repository, open another local terminal tab in its folder. It must have at least one commit and a checked-out branch. List your workspaces, then replace <id> with the target workspace’s ID:
murmello ls
murmello push <id>Push sends commits, branches and uncommitted edits, and asks which untracked or ignored files to include. Review that choice before sending secrets or large files. It refuses to overwrite a workspace that already has repository branches. For later synchronization, use your Git remote from each environment.
For individual files, drag them into a cloud terminal or use Files in the titlebar. The workspace’s ~/pods directory is its own disk; the rest of its home is shared with your other workspaces.
4. Leave, return and bring work back
Use Return in the Cloud panel to detach while leaving the workspace running. From a shell inside the workspace, murmello return does the same. You can also close your laptop while the remote task works.
From your Mac, run murmello resume <id> to reconnect. If the workspace stopped, its files return but processes need to start again. Run claude or codex in the project directory when you need to reopen the agent.
Commit the changes you want inside the workspace. Then, from your local repository, run:
murmello fetch <id>Fetch brings back commits, not uncommitted files. It stores branches under refs/murmello/<project>/* and offers a fast-forward when your current branch is clean and compatible. Review and test the result before integrating it.
5. Speak your prompts
Enable dictation during the tour or in Settings, choose a shortcut and grant the requested microphone and Accessibility permissions. Use your configured hold or toggle shortcut to dictate into the terminal or another app. Hosted dictation sends audio for transcription; read how your data is handled.
Stop when you are finished
murmello stop <id>This stops compute and keeps the disk for your plan’s retention window. To permanently delete a stopped workspace, use Delete in the Cloud panel or murmello rm <id>, which asks for confirmation.