List all themes in the store with their IDs and roles (live, unpublished, development). Use this first to find theme IDs.

Download a theme's files from Shopify into the local theme directory and snapshot the result in git. Pass theme_id (from list_themes); omit to pull the LIVE theme. Run this before starting an editing session so local files are fresh.

List files in the local theme directory. Optionally filter with a substring or simple pattern (e.g. 'sections/', '.liquid', 'countdown').

Read a theme file's contents with line numbers. For large files, pass start_line/end_line to read a slice. Use search_files first to locate the relevant region.

Search all text files in the theme for a string or JavaScript regex. Returns matching files with line numbers and context. Always use this to locate code instead of reading whole files.

Create a new theme file or fully overwrite an existing one, then auto-commit to git. For small edits to existing files prefer patch_file — it is safer and cheaper.

Edit an existing theme file by replacing an exact string. old_str must appear exactly once in the file (include enough surrounding lines to make it unique). Auto-commits to git. Preferred over write_file for edits.

Delete a local theme file and auto-commit. Note: theme_push does not delete remote files unless you push with the CLI's --nodelete disabled; mention this to the user.

Upload the local theme directory to Shopify.

• Default: push to an UNPUBLISHED copy (safe; returns a preview URL).

• Pass theme_id to push to a specific existing theme.

• Pushing to the LIVE theme is BLOCKED unless allow_live=true. Only set allow_live after the user explicitly confirms.

Make an unpublished theme the live storefront theme. DESTRUCTIVE for the current live theme's status — only call after the user has previewed the theme and explicitly asked to publish. confirm must be true.

Show recent git commits for the local theme (every edit auto-commits).

Restore one file to its state at a given commit (from git_history), then commit the revert. Use to undo a bad edit.