Skip to content

Update plugins

Review a new package revision, prepare its settings and activate it while existing work keeps its revision.

Updated 2026-11-10

A plugin update first becomes a candidate for review. Open Settings → Plugins, select the plugin and go to Version. The installed revision continues to serve new work until you activate the candidate.

Load a candidate

For a folder source, edit and validate the source files, then choose Import from folder again. For another source, use Check this source for an update. A pinned GitHub commit or archive hash identifies fixed contents; to move to a new one, stage the new source from the CLI.

Code
farero plugins update <installation> --source github:<owner>/<repository>@<full-commit>
farero plugins update <installation> --source https://example.com/plugin.tgz --sha256 <archive-sha256>

Review settings and data use

Update ready to review shows the candidate revision, components and declared data destinations. Check any new command or destination before activation.

Compatible saved settings carry forward. Fields that need a value or no longer accept the old value appear in the candidate form. Save those values before activating. Farero does not silently convert a value to fit a changed type.

Enter any newly declared key in the update review. For a key the installed version already uses, choose Go to beside its name to reach its field under Keys. Review any role override that no longer fits the package requirements. Save or clear unsaved keys before activating. Your installed revision remains selected while you prepare the candidate.

Activate the revision

Choose Activate beside the candidate version. New work uses that revision once activation succeeds. Commands and Workflows already using an earlier revision keep it until they finish; Version shows any older revisions still in use.

Your scope choices and pause state stay in place. Updating a paused plugin does not resume it.

Update a local sample

Illustrative

01 · Goal

Change the bundled fixture and see the new revision take effect.

02 · Setup

Install File summary from a local folder, enable it for a workspace and run its default example. Add one line to ai.farero/fixture.txt, validate the folder and choose Import from folder again.

03 · Prompt

Prompt
After I activate the File summary update, summarize its bundled fixture with label Updated sample and maxLines 2.

04 · Evidence produced

The Version section shows the new revision. A new command reports the updated total line and word counts; its two-line preview still shows the first two lines.

05 · User review

Check the candidate’s source and settings before activation, then compare the command result with the edited fixture. An earlier command may still report the old counts because it keeps its original revision.