repository·main·Indexed 22 days ago
https://github.com/manaflow-ai/manaflowAn open-source orchestration platform for parallel execution of AI coding agents within isolated, sandboxed VS Code workspaces. Includes documentation for the cmux devbox CLI, which manages Morph Cloud VMs, browser automation via element references, and workspace lifecycle management.
cmux-env is a system composed of a daemon (envd) and a client (envctl) designed to coordinate shared environment variables across different shells and projects.
envd (Daemon): Runs in the background to maintain the state of global and directory-scoped key/value pairs.envctl (Client): The command-line interface used to interact with the daemon to set, unset, list, or export variables.Manaflow is an open-source orchestration platform designed as an alternative to Claude Code, Codex Cloud, or Devin. It allows you to spawn multiple coding agent CLIs (such as Claude Code, Codex CLI, Cursor CLI, Gemini CLI, Amp, and Opencode) to work on tasks in parallel.
Key capabilities include:
The Cloudrouter Sandbox is an Ubuntu 22.04-based environment designed for development and automation. It includes:
/home/user/workspace.You can handle Zod validation errors using hooks. You can provide a hook locally at the route level or globally for the entire application.
Pass a third argument to app.openapi() to intercept the result of the validation. If result.success is false, you can return a custom error response.
Initialize OpenAPIHono with a defaultHook to apply a common error formatter to all routes. Local hooks provided in app.openapi() will override the defaultHook.
// Global Hook
const app = new OpenAPIHono({
defaultHook: (result, c) => {
if (!result.success) {
return c.json({
ok: false,
errors: "formatted_errors",
source: "custom_error_handler",
}, 422);
}
},
});
// Local Hook (Overrides defaultHook)
app.openapi(
createRoute({ /* ... */ }),
(c) => { /* ... */ },
(result, c) => {
if (!result.success) {
return c.json({ ok: false, source: "routeHook" as const }, 400);
}
}
);The cmux devbox CLI manages remote development environments (Morph instances) via the following components:
~/.config/cmux.~/.config/cmux/cmux_devbox_state_{dev,prod}.json.rsync over SSH.--instance flag.The framework supports .annotated.diff files (e.g., full.annotated.diff or individual *.annotated.diff files). Unlike other files in data/, these are tracked in git.
You can use them to manually mark expected issues/bugs as ground truth for evaluation comparisons:
cat apps/www/scripts/pr-review/evals/data/<pr-id>/full.annotated.diffThe OSC 8 sequence enables clickable hyperlinks within the terminal. The renderer must be capable of storing hyperlink state with cells to make the text interactive.
Format:
OSC 8 ; params ; uri ST text OSC 8 ; ; ST
Note: params can include an id=xxx to allow grouping multi-line links.
During the first execution, cmux performs an extraction process to set up its local environment. It extracts bundled files to the ~/.cmux/ directory, which includes:
When building AI agents that use cmux computer commands, follow these patterns to ensure reliability:
@e1, etc.) become stale as soon as the page changes. Always run cmux computer snapshot -i after any navigation or interaction that changes the DOM.fill, use cmux computer get value to confirm the state.cmux computer wait --text or cmux computer wait --url before attempting to interact with new elements.cmux computer save --name=<name> after complex setup steps so you can resume from a known good state using --from=<name> if an error occurs.Shells can emit the OSC 7 sequence to communicate the current working directory to the terminal emulator. This allows the UI to display the directory in tab titles or other metadata.
Format:
OSC 7 ; file://hostname/path ST
The OSC 52 sequence allows applications to interact with the system clipboard or the primary selection.
Format:
OSC 52 ; <target> ; <base64-data> ST
Targets:
c: System clipboardp: Primary selectionOperations:
OSC 52 ; c ; ? ST to receive the current clipboard contents as base64.OSC 52 ; c ; <base64> ST to set the clipboard content.Browser automation in cmux devbox follows a multi-layered architecture:
cmux exec, it reads a worker token from /var/run/cmux/worker-token..http.cloud.morph.so URL) receives requests. It requires a Bearer token for authentication.agent-browser (a Vercel tool) which connects to Chrome via the Chrome DevTools Protocol (CDP).127.0.0.1:9222.