The task runner
your scripts deserve.
Stop scattering commands across READMEs, Makefiles, and Slack threads. Meriadoc gives your project's operations a typed, discoverable, AI-ready home.
brew tap meriadoc-dev/meriadoc brew install meriadoc
Replaces Make · Just · Taskfile
One tool. Every interface.
Tasks
Sequential shell commands with typed env vars, working directories, preconditions, and failure handlers.
Learn more →Jobs
Compose tasks into multi-step workflows with shared environment and configurable failure policies.
Learn more →Shells
Drop into a pre-configured interactive shell with the right env vars already set. Great for environment context switching.
Learn more →Web UI
A browser-based task runner at localhost:8420. Browse, inspect, run with typed inputs, watch output live.
MCP / AI Agents
Native Model Context Protocol. Claude and other agents discover and call tasks as tools, with risk controls and approval gates.
Learn more →Audit Logging
Structured NDJSON for every execution — caller, risk level, outcome, duration. Blocked calls logged too.
Learn more →Up in three commands.
version: v1
tasks:
build:
description: "Build the project"
cmds:
- cargo build --release
deploy:
description: "Deploy to an environment"
agent:
risk_level: high
env:
ENV:
type: choice
options: [dev, staging, prod]
default: dev
cmds:
- ./deploy.sh
jobs:
ci:
description: "Full CI pipeline"
tasks: [build, test]meriadoc config add . meriadoc ls tasks meriadoc run task build Why not Make, Just, or Taskfile?
Great at running commands. Not built for typed inputs, AI agents, or operational visibility.
| Feature | Make | Just | Taskfile | Meriadoc |
|---|---|---|---|---|
| Typed parameters | ||||
| Risk annotations | ||||
| Agent / MCP interface | ||||
| Agent visibility control | ||||
| Web UI | ||||
| Structured JSON output | Partial | Partial | Partial | |
| Audit logging | ||||
| Composite jobs | Partial | Partial |
Built for every workflow.
Developers
Stop copy-pasting commands from READMEs. Add your projects once, run any task from any directory. Shell completions, dry-run preview, typed prompts for the env vars you always forget.
Quick start →Teams
Commit meriadoc.yaml to the repo. New engineers run
meriadoc ls tasks on day one — no tribal knowledge,
no Slack threads, no "ask Alice how to deploy."
Pipelines
Drop meriadoc into any CI step as a direct replacement for Make or Just.
One meriadoc.yaml drives both local dev and GitHub Actions —
no more drift between what runs on your machine and what runs in CI.
Agents
Give Claude a safe, audited execution boundary. Agents discover tasks via MCP,
see typed schemas, and are blocked by risk controls. Every call is logged.
agent.enabled: false hides tasks entirely.
Get Meriadoc.
MIT License. No telemetry. No cloud dependency.