MAWM

Multi-Agent Workflow Management (MAWM) is a TypeScript CLI for packaging and installing LangGraph workflows with the purpose of agent execution and orchestration.

Quick Start

Install the package globally

bun install -g @mawm/cli

Initialize .mawm/ in target-project

mawm init    

Or run it without a global install:

bunx @mawm/cli init

Add the project initiative workspace when you want MAWM's project-local planning docs and templates:

mawm init -i

Install the bundled OpenCode agent assets into the current project:

mawm init -a opencode

Scaffold a new workflow package from a template:

mawm init -t base
mawm init -t initiative

Workflow Management

MAWM separates reusable workflow installation from project-local workflow use.

Install a workflow package or built workflow directory into the user-level MAWM config:

mawm install -g [workflow-or-path]  # installs globally (~/.config/mawm/)

Pull a globally installed workflow into the current project:

mawm install <workflow-id>          # copies into .mawm/graphs/

List installed workflows:

mawm list                           # project-local
mawm list -g                        # global

Reinstall from source or remove:

mawm update [workflow-id]           # reinstall workflow(s) (project-local)
mawm update -g [workflow-id]        # reinstall workflow(s) (global)
mawm remove <workflow-id>           # remove from project
mawm remove -g <workflow-id>        # remove from global config

Command Reference

# initialize project state, user config, agent assets, or workflow templates
mawm init [-g] [-i] [-a <agent>] [-t [type]]  

# install workflows globally or into the current project
mawm [i, install] [-g] [workflow-or-path]      

# list project-local or global workflows
mawm list [-g]                                 

# reinstall one or all workflows from their source
mawm [u, update] [-g] [workflow]               

# remove an installed workflow
mawm [rm, remove] [-g] <workflow>              

Shipped Assets

The package ships the CLI plus assets copied into dist/assets during build:

• Project-local .mawm scaffolds for workflow manifests and initiative/adhoc planning docs.
• User-level MAWM config scaffold with an empty workflow manifest.
• OpenCode agent and tool assets, including workflow-runner and initiative-manager agents plus the execute-graph tool.
• base and initiative workflow templates built from shared LangGraph template assets.

The repository also includes workflows/examples/coding as a source example for a richer initiative workflow. It is not a CLI command and is not installed by mawm init.

Running Workflows

Workflow execution is currently handled outside the top-level CLI. Generated workflow packages include LangGraph project files, and the bundled OpenCode assets include an execute-graph tool that can launch installed workflows when used by the relevant OpenCode agent.

Status

MAWM is in active development and pre-release.

Post-v0.1.0 Direction:

• Running globally installed workflows with project-local customization.
• Expanding the root MAWM config into a broader hub for workflow and agent-development settings.
• Broader agentic-development integrations, including ClaudeCode and Codex support alongside OpenCode.
• Other features, improvements, and fixes.

Stack