Getting Started
Quick Start
Get Modula installed and ready to run its first task. Takes about five minutes if you already use a coding agent CLI.
Prerequisites
- macOS, Windows, or Linux.
- At least one supported coding agent CLI installed and logged in: Claude Code , Codex , or OpenCode .
- A local git repository you want agents to work on.
Install Modula
Grab the build for your platform, open the app, and follow the setup flow. Everything runs locally: one app, one local database, no cloud account.
Create a workspace
The setup flow first asks for a workspace. A workspace groups everything that works together: your projects, agents, providers, tasks, and the knowledge agents accumulate. Give it a name and you’re through.
Add a provider
Next, connect a provider: the coding agent CLI your agents will run on. Pick the type (Claude Code, Codex, or OpenCode) and confirm its config directory; the default is right if you installed the CLI normally. You can add more providers later and mix them across agents.
Add a project
Finally, add a project: a git repository agents are allowed to work on. Point Modula at an existing repo on disk and pick its base branch, or clone one fresh from a git URL.
Agents work on isolated branches in worktrees under <project>/.worktrees/, so add .worktrees/ to the repo’s .gitignore.
That’s the whole setup. Your workspace comes with a default team of agents already wired into a working pipeline.
Run your first task
Follow Your First Task to take a task from ticket to merged code, or read the overview for the product model first.