Docs menu

Get Started

Common workflows

These are the jobs people hand to Midas most often. Each starts with a plain-language prompt. Midas reads what it needs, makes the change, runs the checks, and shows you the diff.

Ship a feature

Say what you want and anything that limits it. Midas makes a plan, edits the files it needs, runs your checks, and shows the diff.

Add pagination to the audit log endpoint. Use the existing cursor pattern, add tests, and update the API docs.

Fix a bug

Give Midas the symptom and where it fails. It reads the surrounding code, reproduces the failure, and fixes the cause.

Builds fail on Node 22 with a module resolution error. Find the cause, fix it, and run the suite.

Add tests to code that has none

Point at the module and the behavior you care about. Midas reads the implementation, writes the cases, and runs them.

Add tests for src/pricing.ts. Cover the discount tiers, the rounding rule, and the empty cart.

Review a diff

Review uncommitted changes, a commit, a branch, or a pull request. Midas reads the full file around each change.

/review

Refactor without changing behavior

Say what may change and what must stay the same. Midas moves the code and keeps the tests passing.

Split the billing module into invoice, refund, and webhook files. Do not change public behavior. Keep the tests passing.

Upgrade a dependency

Midas bumps the version, reads the migration notes, and fixes the code the upgrade breaks.

Upgrade the Postgres client to the next major version. Read the migration guide and fix the call sites.

Write release notes

Give it the range and who will read it. Midas reads the commits and writes the notes.

Write release notes for everything since v1.8.0. Group by feature, fix, and breaking change.

Onboard into an unfamiliar codebase

Ask for a tour before changing anything. Nothing is edited until you ask.

Give me a tour of this codebase. What does it do, where does the work happen, and what should I read first?

Run two agents in parallel

Put each session in its own git worktree, so they do not fight over the index.

midas --worktree billing-fix
midas --worktree search-filter

Automate in CI

Run one task headlessly and print JSON, so a script or CI job can read the result.

midas run "review this branch for security issues" --format json

Turn a workflow into a command

If you run the same prompt often, save it as a command or a skill. A command lives in .midas/commands/ and becomes a slash command with its file name. A skill is a folder with a SKILL.md and can carry reference files beside it.

See Skills for the file format and the team registry, and Slash commands for every command.