Getting Started

What is FlagShark?

FlagShark is an automated feature flag lifecycle management platform. It integrates with GitHub to detect stale feature flags in your codebase and generates cleanup pull requests to remove them safely. Think of it as automated technical debt reduction for your feature flag infrastructure.

How does FlagShark detect feature flags?

We use tree-sitter AST parsing for our core languages (TypeScript, JavaScript, Go, Python, Java, C#, PHP, Rust) and precise regex patterns for the rest. AST parsing understands your code's actual structure, so we identify real flag usage, not false positives from comments or strings.

What programming languages are supported?

FlagShark detects feature flags in 13 languages. Transformation support is narrower and is never inferred from language alone: exact registered provider, runtime, SDK method shape, validation, and capability stage must match. JavaScript, TypeScript, and Python have selected draft-PR cells; selected Go, Java, Kotlin, and Ruby cells are preview-only. Every generated cleanup PR starts as a draft. The live support matrix reports each exact cell's pre-GA, GA, or paused state; a GA cell can become ready only after the repository's configured CI passes on the exact generated commit.

What feature flag providers do you support?

Detection covers LaunchDarkly, PostHog, Unleash, OpenFeature, ConfigCat, GrowthBook, Flagsmith, Statsig, Split, and custom patterns. Cleanup is a separate capability: eight provider families have selected exact built-in preview or draft-PR cells, and a detected provider by itself never enables transformation. Custom patterns remain detection/assessment-only until a versioned profile passes fixture and validation checks.

How do I sign up for FlagShark?

You can sign up using your GitHub account for instant access, or create an account with email and password if you prefer. Both options give you full access to the platform. GitHub sign-in is recommended as it streamlines the repository connection process.

How It Works

How does FlagShark determine if a flag is safe to remove?

FlagShark analyzes multiple signals: flag age, PR history, and code context using syntax-aware parsing (tree-sitter AST for our 8 core languages, precise regex for the rest). Flags that have been in your codebase for extended periods without changes are identified as stale candidates. For LaunchDarkly users, we can also detect flags that have been removed from your LaunchDarkly project but still exist in code.

Will FlagShark work with our CI/CD pipeline?

Yes. FlagShark operates via GitHub webhooks and creates standard pull requests. It integrates with GitHub Actions, Jenkins, CircleCI, or any CI/CD system, with no pipeline changes required.

How long does it take to see results?

You'll see your complete flag inventory and health scores within minutes of installation. Most teams create their first cleanup PR the same day. Significant codebase improvements are typically visible within 1-2 weeks.

Can we mark critical flags to prevent removal?

Yes. FlagShark supports "permanent flag" protection. Mark any flag as critical, and it will be excluded from cleanup recommendations and stale alerts. This is configurable per workspace.

Security & Privacy

Does FlagShark store my source code?

No. Code is analyzed in isolated AWS Lambda environments and discarded after processing. We only store metadata: flag names, file locations, and lifecycle status. GitHub usernames are stored for flag attribution. Your source code is never persisted.

What GitHub permissions does FlagShark need?

Three permissions: Contents (Read) to analyze code, Pull Requests (Write) to create cleanup PRs, and Metadata (Read) for repository info. We never access secrets, environment variables, or admin settings.

Is FlagShark SOC 2 compliant?

We use AES-256 encryption at rest, TLS in transit, and AWS KMS for secrets management. SOC 2 Type II certification is in progress. We're GDPR ready with data deletion available on request. Scan results auto-delete after 30 days; flag lifecycle data is retained while your account is active.

What if we accidentally remove a critical flag?

FlagShark creates pull requests. You review and approve before anything merges. Your team has full control to test, discuss, and catch concerns. No automated merging without your approval.

Pricing & Plans

Is there a free tier?

Yes. FlagShark Free includes 3 repositories, 50 flags, core detection features, and 30-day data retention, free forever. Paid plans start at $49/month for teams needing more repositories and advanced features.

How much will FlagShark save us?

Teams save an average of $125,000+ annually based on industry research (2.5 hours per flag × developer hourly rate × flags cleaned). Use our ROI Calculator for estimates based on your team size.

Technical

Does FlagShark work with monorepos?

Yes. FlagShark handles multi-workspace setups with hundreds of repositories. Organize repos into teams with role-based access control, and use bulk operations for cleanup at scale.

Do you support GitLab or Bitbucket?

Currently GitHub-only via native GitHub App integration. GitLab and Bitbucket are on our roadmap. Contact us for enterprise timeline discussions.