# Muxlio – Durable Agent Workflows

> Source: <https://github.com/Muxlio/muxlio>
> Published: 2026-11-19 21:32:09+00:00

**Key takeaway:** Muxlio's implement-features recipe runs build and tests before each local commit and pauses after ten failed verification attempts, letting a developer review changes and test output before pushing.

Build a workflow. Let your agents run it.

[Documentation](https://muxlio.github.io/muxlio/) ·
  [Get started](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/service.md) ·
  [Implement-features recipe](https://github.com/Muxlio/muxlio/blob/main/recipes/implement-features/workflow.ts) ·
  [Apache-2.0](https://github.com/Muxlio/muxlio/blob/main/LICENSE)

Muxlio runs multi-step workflows across AI agents and command tools. You or your assistant define the steps, their inputs, and the checks they must pass. Muxlio executes the workflow, saves progress, and gives you a place to follow the work.

Use it for work that needs several steps, checks, or hand-offs. Your client can disconnect while the coordinator continues running. You can return to the run's status, logs, outputs, and any failure that needs attention.

I use Muxlio to develop Muxlio itself. The
[implement-features recipe](https://github.com/Muxlio/muxlio/blob/main/recipes/implement-features/workflow.ts) works through
features one at a time:

```
Implement → Review → Run checks → Commit locally → Next feature
                         │
                         └─ if checks fail: Fix → Run checks again
```

The workflow runs the repository's build and tests before committing. After ten unsuccessful verification attempts it pauses for attention. You can inspect the change, review notes, test output, and execution history before deciding to push. Each verified commit becomes the starting point for the next feature.

To run the batch in a private Git clone, follow the
[Docker Sandbox walkthrough](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/docker-sandbox.md). One sandbox worker
offers Claude Code, Codex, Cursor, and shell commands. The example takes two
dependent features from setup through preflight, execution, and fetching the
commits. The [live recipe](https://github.com/Muxlio/muxlio/blob/main/recipes/README.md#append-features-to-a-running-batch)
also lets you add features to the same branch while the batch is running.
If you set up both workspaces, choose `localhost` to run on the host or `sandbox`
to run on the `sbx` worker.

I keep Muxlio running on a Mac mini, queue work through my assistant, and review progress later. You choose the machine: your workstation, another computer, or a server. The execution host needs to stay running; your chat session does not.

This is one workflow, not a special product command. Adapt the
[recipe's tasks and checks](https://github.com/Muxlio/muxlio/blob/main/recipes/implement-features/tasks.ts) to your own project,
or build a workflow for research, data processing, documents, or other work.

With [Homebrew](https://brew.sh) available on macOS or Linux:

```
brew tap Muxlio/muxlio https://github.com/Muxlio/muxlio
brew install --HEAD Muxlio/muxlio/muxlio
muxlio version
```

This builds the current `main` branch and installs the CLI, MCP server, adapters,
and web UI. Homebrew handles the build dependencies; you do not clone the repo.
Install and sign in to the agent CLIs your workflows will use separately.

With Muxlio installed, initialize the workspace where work should happen:

```
muxlio init --client kiro --scope project
muxlio service start
```

Choose `--client` for your authoring assistant. `init` allows all bundled
executors by default, including agent tools, commands, workspace writes, and network access. Change
`executors` in `~/.muxlio/config.json` to restrict permissions; repeated init
preserves explicit policies and disabled executors. `init` prepares the workspace settings,
credentials, agent instructions, and MCP settings. The service starts the
coordinator, local worker, UI, and configured MCP listener together.

[Connect your assistant through MCP](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/mcp.md), then ask it to build a
workflow for your task. Describe the inputs, the steps to run, and the output you need.
Have it validate the workflow and show you the plan before starting the run.
Developers can also author workflows directly with the TypeScript SDK.

The installed service does not need Muxlio's source checkout. Workers need the
files, authenticated agent CLIs, and tools required by your workflow.
[Source-build instructions](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/architecture/developer-reference.md#build-from-source)
are available if you prefer to build the runtime yourself.

Open **[http://localhost:7600](http://localhost:7600)** or ask your assistant for run status. Inspect the
execution graph, attempts, live logs, and generated artifacts. Pause, resume, or
retry when appropriate. Uncertain external effects require reconciliation before
work can safely repeat.

To launch a registered workflow from the dashboard, select its version and an
authorized workspace, enter the inputs, and run preflight. See the
[dashboard guide](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/ui-operations.md#launch-a-workflow).

```
muxlio service stop
muxlio service restart
```

| Start here | Go deeper | 
|---|---|
| [Which adapter should I use?](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/adapters.md) — native CLIs, ACP, and A2A | [Adapter capability reference](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/architecture/developer-reference.md#run-with-real-adapters) | 
| [Service Guide](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/service.md) — setup and service controls | [Service reference](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/architecture/service-reference.md) | 
| [Docker Sandbox walkthrough](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/docker-sandbox.md) — run dependent features in a private clone | [Worker protocol](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/architecture/worker-protocol.md) | 
| [MCP Integration](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/mcp.md) — build and run from your assistant | [MCP tools and protocol](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/architecture/mcp-reference.md) | 
| [Observability UI](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/ui-operations.md) — follow progress and results | [Operations API](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/architecture/operations-reference.md) | 
| [Benchmarks](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/benchmarks.md) — what the suite checks | [Benchmark methodology](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/architecture/benchmark-methodology.md) | 

Explore the [architecture](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/architecture/overview.md),
[execution and security contracts](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/architecture/execution-security.md),
and [CLI, SDK, and configuration reference](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/architecture/developer-reference.md).
The [example recipe](https://github.com/Muxlio/muxlio/blob/main/recipes/implement-features/workflow.ts) and
[authoring guide](https://github.com/Muxlio/muxlio/blob/main/muxlio-skills/SKILL.md) show how workflows are put together.

`muxlio init --client NAME --scope project --workspace /absolute/project` installs
the discoverable Muxlio skill and its references in that project. Use `--scope user`
for discovery across projects. See [client skill setup and invocation](https://github.com/Muxlio/muxlio/blob/main/muxlio-docs/mcp.md#install-and-invoke-the-muxlio-skill)
for supported paths, Cursor version handling, and preservation of existing edits.

Installed releases support offline JSON authoring: run
`muxlio template echo > workflow.json`, then `muxlio check workflow.json`.
The `echo` template needs no executor; `muxlio template task` shows a generic
task with input and output bindings. Templates are embedded in the binaries
and shipped in `share/muxlio/templates`. With MCP, use `workflow_template`,
then `check_plan` and `start_run`. No Node packages or registry access are
needed for JSON authoring, validation, fake testing, or submission.

See [the installed authoring guide](https://github.com/Muxlio/muxlio/blob/main/muxlio-skills/references/authoring.md) for
an empty-workspace example and submission instructions. Optional TypeScript/
JavaScript compilation executes arbitrary code, requires
project-local dependencies installed from
your pinned lockfile, and never implicitly downloads packages.
