DEV Community

Arshdeep Singh
Arshdeep Singh

Posted on

Motus: The Automation Framework That Gives Claude Code Structure

Claude Code is powerful, but your automations quickly become scattered files and forgotten prompts. Motus gives it structure — departments, agents, and workflows organized like a real company.


What Is Motus?

Motus is an automation framework for Claude Code. It organizes AI workflows into departments (logical groups), agents (AI workers with defined roles), and workflows (multi-step automations). Instead of loose scripts, you get a structured hierarchy with automatic documentation.

The Architecture

  • Departments: Logical groupings (marketing, engineering, life, etc.)
  • Agents: AI workers with specific roles (data-fetcher, orchestrator, specialist)
  • Workflows: Multi-step automations that combine agents
  • Registry: JSON-based tracking of all components

Key Components

  • 4 Creation Wizards — departments, agents, workflows, docs
  • 11 Handlebars Templates — agent definitions, workflow configs
  • 20+ Template Helpers — string transforms, conditionals
  • OAuth Manager — Web UI for managing API connections
  • Doc Generator — auto-generates docs from registries

Real Example: Morning Briefing

Create a 'life' department with weather-fetcher, calendar-fetcher, and task-compiler agents. Combine into a morning-briefing workflow that runs daily at 7 AM. All agents execute in parallel, results compile into one output.

Requirements

  • Claude Code CLI
  • Node.js 18+
  • MIT License

GitHub: https://github.com/openmotus/motus

Written by Arshdeep Singh

Top comments (0)