feat: Add --fresh for clean skill output rebuilds#850
Open
gigerIT wants to merge 1 commit into
Open
Conversation
- Introduced a new `--fresh` option in `InstallCommand` and `UpdateCommand` to clean up output folders by deleteing each of agent's generated skills directories before installation or update. - Updated `SkillWriter` to handle the fresh sync logic, ensuring untracked entries are removed and dangling symlinks are cleaned up. - Added tests to verify the functionality of the fresh sync feature, ensuring it behaves correctly under various scenarios.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a
--freshflag toboost:updateandboost:installthat deletes each selected agent’s generated skills directory before running the normal skill sync.Why
We have run into this a few times in real projects: generated skill folders can end up with dangling symlinks, stale files, or broken copied directories after switching between operating systems, resolving merge conflicts, or committing generated agent output by mistake.
The fix was always straightforward: delete the generated skills folder manually, then rerun
boost:updateorboost:install.This flag makes that cleanup an explicit Boost workflow instead of a manual recovery step.
Behavior
When
--freshis passed, Boost removes the generated skills directory for each selected agent before syncing skills again.Default behavior is unchanged unless
--freshis passed..ai/skillsremains untouched.Use case
This is useful when generated agent directories contain files that are no longer part of the current Boost sync result. Without deleting the generated directory first, those stale files can remain present and continue influencing the agent.
Example:
or:
Safety
The source
.ai/skillsdirectory is preserved.Running
boost:updateorboost:installwithout--freshbehaves exactly as before.Tests
Tests cover:
boost:update --freshboost:install --fresh.ai/skillsis preserved--fresh