export-microfeed-theme

name	export-microfeed-theme
description	Initialize or export a microfeed theme from a saved instance into an independent local repository, then install, validate, test, and preview it safely. Use when a coding agent is asked to initialize, export, copy, fork, inspect, or begin developing the active or a specific installed theme from a microfeed instance.

Initialize or export a microfeed theme

Use the project-owned yarn manage CLI from the microfeed repository root. Read the theme section of docs/manage-cli.md before using an unfamiliar option.

Choose the repository identity

1. Run yarn manage instances --json and select the exact saved instance the user named. If several instances remain plausible, report their names and ask the user to choose.

2. Use theme init when the user wants a new independently versioned theme based on the site's effective appearance:

   yarn manage theme init <output-directory> --instance <instance-name> --json
   

   Let the CLI choose the initial local.<directory-name> package ID unless the user supplied a package ID, name, version, or author. The command initializes Git by default; pass --no-git only when the user wants another tool to initialize the repository.

3. Use theme export when the user wants to preserve one exact installed package identity. Export the active installed version by default:

   yarn manage theme export --active --instance <instance-name> --git --json
   

   When the user names an immutable theme ID, replace --active with that ID. Let the CLI choose .microfeed/themes/<package-id>-<version>/ unless the user supplied another empty output directory.