Lenslet AWS access review for CI

AWS access, in every PR.

Run your tests against a local AWS emulator. Lenslet records every call, explains failures, and flags new IAM permissions in the pull request.

The macOS app is not notarized: the first time, use Open Anyway in System Settings → Privacy & Security.

  • macOS / Linux
  • Apache-2.0
  • Nov 15, 2026
Lenslet’s Access view after a test run: seventeen permissions, each with its resource and call count; dynamodb:DeleteItem is marked new.
The Access view after a demo run; one permission is new. Captured at v3.0.0

Why a call failed

Every call, with the AWS error in its row and the request and response a click away.

Lenslet’s Calls view: each AWS call with its service, status and latency; an S3 NoSuchKey and an SQS QueueDoesNotExist error show in their rows.

Why it failed, and what it needs

Why it failed

The AWS error code and message, with a likely cause for common local failures.

What it needs

Each call becomes an IAM action on a resource, implied permissions included.

A lock you commit

lenslet.lock lists your project’s access, one permission per line, sorted.

The diff in the PR

One comment per pull request; CI fails until someone accepts new access.

Unused access too

--check --strict also fails on lock lines the run did not use.

A policy from the lock

lenslet policy writes an IAM policy, leaving out lines only tests need.

Get started

Start your emulator first: AWS Emulator, moto and LocalStack all work. lenslet init writes the lock and a CI workflow; commit both.

  1. Install (Linux, macOS)

    curl -fsSL https://github.com/hxddh/lenslet/releases/latest/download/install.sh | sh
  2. First run: the lock and the CI workflow

    lenslet init -- npm test
  3. Fail when the code needs access the lock lacks

    lenslet run --check -- npm test

Where your data goes

FAQ

Is the lock a security review?

No. It is the access your tests exercised, mapped by rules. Code paths the tests never reach are not in the lock.

Which AWS services does it read?

Resources are read for S3, DynamoDB, SQS, SNS, Lambda, Secrets Manager, KMS, STS, IAM, EventBridge and Step Functions. Other services get * .

Does it run on Windows?

No. There are builds for macOS (universal) and Linux (x86_64 and aarch64), including a static CLI for Alpine and CI images.