Documentation Ways to access Guardian · Menu
ACCESS

Ways to access Guardian

There are five ways to reach Guardian. Four of them run entirely on hardware you control, and the fifth does not exist yet. This page says which is which, and what each one needs from you.

Compare methods

Guardian access methods compared by intended user, account requirement, network requirement, data location and status
MethodIntended userAccountInternetData locationStatus
Local CLIDevelopers and automationNo account is involved in a local scanNot required — the scan help states scans never use the networkYour machineVerified
macOS applicationDevelopers who prefer a graphical interfaceNot documented — no verified release existsNot documented — no verified release existsYour machineBlocked
Your CI/CD pipelineEngineering teams enforcing a release gateWhatever your CI provider already requiresWhatever your CI environment already doesYour own CI runnerPreview
Generated reportsDevelopers, QA, security reviewers and release managersNone for a locally generated reportNot required to generate or open oneThe output path you chooseVerified
Sanitized findings sharingTeams that choose connected collaborationA separate product, with its own accountRequired, only if you enable itOnly findings you have inspected and approvedPlanned

How Guardian reaches a project

  1. You point it at a local project.

    A directory that already exists on your machine or on your CI runner. Guardian does not fetch anything and does not ask where your code is hosted.

  2. It detects the project structure.

    Flutter, native iOS or native Android, and which analysis paths apply to what it found.

  3. It reads the files the enabled checks need.

    Project manifests, platform and release configuration, dependency declarations and source. Nothing is transmitted to read them.

  4. It writes findings and a report locally.

    To the path you choose. The report is a file you own from the moment it exists.

  5. Sharing is a separate, explicit decision.

    Nothing leaves the machine unless you send it. There is no automatic upload of any kind.

What Guardian never asks for

Normal scanning needs none of the following. If something claiming to be Guardian asks you for any of them, that is worth a second look.

  • Source code upload
  • APK or IPA upload
  • Signing certificates or signing keys
  • Provisioning profiles
  • Environment secrets or API tokens
  • Production database credentials
  • Production database rows
  • Raw reports sent anywhere automatically

Method by method

Local CLI

Verified

The command surface is verified from the bundled CLI’s help output. How the CLI is distributed is not yet public.

  • You point the CLI at a project directory that already exists on your machine.
  • It detects the project structure, runs the enabled analyzers over local files, and writes findings and a report locally.
  • There is no upload step in a scan, and no account to create.
  • A public installation route has not been published yet. If you already have the CLI, the getting-started guide shows how to confirm it works.
Confirm an installed CLI

macOS application

Blocked

Release verification is in progress. There is no download.

  • The macOS application is a native front end that calls the same local engine through a JSON boundary, which keeps the CLI as the source of truth.
  • Its distribution build is completing signing, notarization and Gatekeeper verification. We publish a download when those pass, and not before.
  • System requirements and architecture support will be published with the first verified release, so the numbers you read are the numbers that shipped.
Release status

Your CI/CD pipeline

Preview

The commands are verified. The installation step inside CI is not, so the templates mark it explicitly.

  • Guardian runs inside the runner you already control. It is the same CLI, invoked by your pipeline.
  • Nothing is sent to a Guardian service. Your CI provider still processes your repository under your own configuration — that is your existing arrangement with them, not something Guardian introduces.
  • The templates leave the installation step clearly marked, because a public installation route has not been published.
CI/CD templates

Generated reports

Verified

Text, JSON, SARIF, GitLab and HTML are verified from the CLI’s help output.

  • A report is a file Guardian writes where you tell it to. Nothing is uploaded to produce one.
  • Reports are the usual way a non-developer sees Guardian output: a QA lead or release manager reads the HTML report rather than running the CLI.
  • A report can contain file paths and project structure, so review one before sharing it outside your team.
Reports and formats

Sanitized findings sharing

Planned

Not built. Nothing leaves your machine today by any route Guardian provides.

  • An optional future integration would send normalized, redacted findings — never source, builds, binaries, secrets or raw reports.
  • It would be off by default, and would require you to inspect the exact outbound payload and approve it.
  • A failure in any connected feature must never prevent a local scan from completing.
  • Guardian is independently usable, and understanding any other product is not a prerequisite for using it.
Security and privacy