Loading...
Automation
From Detection to Cleanup, Automatically
Stop manually hunting down stale flags. FlagShark generates clean, reviewable pull requests that remove flag debt safely.
app.flagshark.com/cleanup-prs
How Automated Cleanup Works
A simple, safe workflow that keeps you in control.
Step 1
Detect
FlagShark identifies stale flags across your codebase
Step 2
Review
You review flagged items and approve removals
Step 3
Generate
One click creates a clean PR with all necessary changes
Step 4
Merge
Review, test, and merge like any other PR
Under the Hood
The cleanup engine, end to end
Six stages, one continuous pipeline. Inputs flow in, outputs branch off at the stage that produces them, and the engine keeps PRs in sync as your codebase moves.
The Engine
Push to default branch·your-org/your-repo
- 1
Scan & Index
tree-sitter ASTWalk the default branch, parse every supported file with tree-sitter, build the flag inventory.
- 2
Stale Decision
age + policyPick candidates by age threshold and per-workspace policy. Skip permanent flags and anything with an open PR.
- 3
Provider Sync
LaunchDarkly APICross-reference each candidate against your flag provider. Only archived flags survive to the next stage.
- 4
Transform
Polyglot PiranhaPolyglot Piranha rewrites the AST: removes the flag check, the dead branch, dead helpers, and stale imports.
- 5
Open Cleanup PR
Git Trees APIAtomic multi-file commit via GitHub Git Trees API. Body explains the flag, the provider state, and the diff.
- 6
Regenerate on Drift
auto re-runWatches the PR. On base-branch push, conflict, or manual click, re-runs the pipeline and force-pushes the new commit.
loops back to step 5
Cleanup PR opened on GitHub, ready for review
Automation That Keeps You in Control
Powerful automation with safety guardrails at every step.
One-Click Cleanup PRs
Generate pull requests that safely remove stale flags with proper code cleanup. Review and merge when ready.
Safe Removal Checks
Automated verification ensures flags are actually unused before removal. No accidental deletions.
Scheduled Policies
Set up automatic cleanup policies. Remove flags that have been stale for X days automatically.
Bulk Operations
Select multiple flags and perform batch operations. Clean up entire categories at once.
Configurable Thresholds
Define what "stale" means for your team. 30 days? 90 days? You decide the rules.
Permanent Flag Protection
Mark critical flags as permanent to exclude them from auto-removal and stale alerts.
app.flagshark.com/repositories
Clean PRs, Ready to Merge
Every cleanup PR includes proper code removal, updated imports, and a clear description of what's being cleaned up.
- Complete flag removal across all affected files
- Updated imports and cleaned up dead code paths
- Detailed PR description with flag history and context
- Links back to original flag introduction PR
Remove stale flag: ENABLE_NEW_CHECKOUT
Ready for reviewby flagshark-bot
This PR removes the stale feature flag `ENABLE_NEW_CHECKOUT`.
Changes:
- if (isEnabled('ENABLE_NEW_CHECKOUT'))
+ // Flag removed - new checkout is now default
Flag age: 127 days • Added in PR #234 • 3 files affected
Stop cleaning up flags manually
Let FlagShark do the heavy lifting. You just review and merge.