Skip to content
Docs

diff

Show what a Deploy changed in its App's code, file by file.

The tool of basemodo diff, on the local MCP and the remote one. It only reads, so an agent's client may run it without asking you.

Compares the Deploy's code with the code of the Deploy live just before it went live, so a Rollback shows what it undid; a Deploy that never went live is compared with the one live when it ended, and the App's first Deploy with no code. With a second Deploy of the same App, compares the first with it. Each file says whether it was added, changed or removed, or only its mode changed (executable or not), with the lines added and removed and its unified diff. Text files of up to 1 MB are compared line by line; a binary or larger file is too large to compare. A file moved is one removed and one added. A long diff is cut: the files past it are named, each to ask for alone with --path.

Arguments

  • deploy (text, required): The Deploy whose changes to show (its id, from basemodo deploys).
  • other (text): Another Deploy of the same App to compare it with. Default: the one live just before it went live (live when it ended, for one that never went live).
  • path (text): Compare only this file, or the files of this folder: how to see a file whose diff a long answer left out.

On the remote MCP

The same on the remote MCP.

Answer

It answers {"deploy", "against" (the Deploy compared with, null for the first), "changes": {"files_added", "files_changed", "files_removed", "lines_added", "lines_removed"}, "files": [{"path", "status" (added, changed, removed or mode), "mode" (100644, or 100755 for executable), "previous_mode", "lines_added", "lines_removed", "diff", "too_large_to_compare", "left_out"}], "left_out": [paths whose diff the answer left out]}. A Deploy of another App, as either, is an error with code deploy_not_found; one whose code is no longer kept, code_not_kept.