AI AGENTS

Shell-Gated Monorepo Batch Upgrade Agent

Walks each package in a monorepo, bumps shared dependencies one at a time, runs that package's tests in a sandboxed shell.

CategoryAI Agents
Enginepaperclip
Difficultyadvanced
Triggerschedule
Steps6
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerScheduled workspace scan
  • ActionEnumerate packages depending on target version
  • ActionBump and test each package in sandboxed shellShell
  • LogicKeep passing bumps, discard failures
  • ActionStage surviving changes and open grouped GitLab MRGitLabGitLab
  • OutputReturn MR with upgraded vs skipped package listGitLabGitLab

What it does

This agent handles the messy reality of monorepos. It iterates package by package, attempts a pinned bump in each, validates it in isolation, and assembles one consolidated GitLab MR that includes only the upgrades that survived their tests.

When to use it

Use it in a Turborepo or pnpm workspace where a shared dependency spans many packages and a single all-or-nothing bump is too risky. You get partial progress instead of a stalled upgrade.

How it works

  1. 1A schedule starts the workspace scan.
  2. 2The agent enumerates workspace packages that depend on the target version.
  3. 3For each package it applies the pinned bump and runs that package's test command in a sandboxed shell.
  4. 4A logic gate keeps passing bumps and discards failing ones, recording which packages were skipped and why.
  5. 5The agent stages the surviving changes onto one branch and opens a grouped GitLab MR.
  6. 6The MR body lists upgraded versus skipped packages as the final output.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect ShellRun sandboxed commands inside the workspace.
  2. 2
    Connect GitLabRepos, MRs, pipelines, registry.
  3. 3
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  4. 4
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  5. 5
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.