amber-scanner

byKeval

GitHub API Key Scanner Website, Project Overview Create a comprehensive web-based system that scans all public GitHub repositories for exposed AI API keys (OpenAI, Anthropic, Google AI, etc.) in every 2 min and displays the findings on a live dashboard. The system should automatically detect, validate, and display the GitHub repository URL The exact file path and location where the exposed key is detected. (add option to put api key of github to connect)

LandingSettingsDashboard
Landing

Comments (0)

No comments yet. Be the first!

Project Tasks12

#1

Implement Theme & Structure

To Do

As a user, I want to see a visually consistent UI so that all pages match the amber-scanner mock designs exactly. This task covers implementing the global color palette (#0A1F44 background, #142850 surface, #E8F1F2 text, #F9A826 amber accent, #27496D muted), typography, shared layout components, and removing any scaffold pages not needed by the project (e.g. generic welcome page). This task is independent and must be completed before any page-specific implementation begins.

AI 80%
Human 20%
High Priority
1.5 days
Frontend Developer
#5

Implement GitHub Scan API

To Do

As a user, I want the system to automatically scan public GitHub repositories every two minutes so that exposed AI API keys are continuously detected. Implement a FastAPI backend service that uses the GitHub API to search public repositories for exposed keys (OpenAI, Anthropic, Google AI, etc.), runs on a 2-minute interval scheduler, stores findings (repo URL, file path, key location, obfuscated key value, timestamp in IST) in MySQL via Alembic-managed schema, and exposes REST endpoints for the dashboard to consume.

AI 75%
Human 25%
High Priority
3 days
Backend Developer
#2

Build Landing Page

To Do

As a user, I want to see an engaging landing page so that I can understand the amber-scanner system at a glance and navigate to the dashboard. Implement the Landing (v2) JSX design including the animated 'Code Matrix' scrolling background, interactive repository map, key detection amber pulse animation, dynamic stats panel, and micro-interactions with amber ripple hover effects. Entry point for both Student/Developer and Educator/Trainer personas.

Depends on:#1
Waiting for dependencies
AI 90%
Human 10%
High Priority
2 days
Frontend Developer
#3

Build Dashboard Page

To Do

As a user, I want to view a live dashboard so that I can monitor real-time exposed API key findings from public GitHub repositories. Implement the Dashboard (v2) JSX design including live findings feed, repository URL display, file path and key location details, stats panel (repos scanned, keys detected, common file types), and custom scan results view. Supports navigation from Landing and links to Settings. Used by both Student/Developer (View Live Findings, View Key Details, View Custom Scan) and Educator/Trainer (Monitor Findings, View Repo Details, View Stats Panel, Guide Scan Session) personas.

Depends on:#1
Waiting for dependencies
AI 85%
Human 15%
High Priority
2.5 days
Frontend Developer
#4

Build Settings Page

To Do

As a user, I want to configure my GitHub API key so that I can connect and customize the scanning process. Implement the Settings (v2) JSX design including the GitHub API key input field, secure save/update functionality, and connection status indicator. Navigated to from the Dashboard by both Student/Developer (Input GitHub Key) and Educator/Trainer (Configure API Key) personas, returning to the Dashboard after configuration.

Depends on:#1
Waiting for dependencies
AI 85%
Human 15%
High Priority
1 day
Frontend Developer
#6

Implement Key Validation Service

To Do

As a user, I want detected API keys to be validated so that only authentic exposed keys are displayed on the dashboard. Implement a backend validation service in FastAPI/Python that checks each detected key against the respective AI provider's API (OpenAI, Anthropic, Google AI, etc.) to confirm authenticity, marks keys as valid/invalid in the database, and exposes validation status via the findings API.

Depends on:#5
Waiting for dependencies
AI 70%
Human 30%
High Priority
2 days
Backend Developer
#8

Implement GitHub Key Settings API

To Do

As a user, I want to securely save my GitHub API key so that the system can use it for customized scanning without exposing it. Implement a FastAPI endpoint to accept, encrypt, and store user-provided GitHub API keys in MySQL, with retrieval for use in the scanner service. Supports the Settings page form submission.

Depends on:#5
Waiting for dependencies
AI 75%
Human 25%
Medium Priority
1 day
Backend Developer
#11

Implement AI Assistant API

To Do

As a user, I want to interact with an AI assistant so that I can get user-friendly explanations about detected findings, key risks, and secure coding practices. Implement a FastAPI AI assistant endpoint using GPT 5.4 via LiteLLM for LLM routing and Langchain for prompt orchestration. Supports the dashboard/ai-assistant page.

Depends on:#5
Waiting for dependencies
AI 70%
Human 30%
Medium Priority
2 days
AI Engineer
#7

Implement Live Findings API

To Do

As a user, I want the dashboard to receive real-time findings so that I can see newly detected exposed keys without refreshing the page. Implement a FastAPI WebSocket or SSE endpoint that streams live scan findings to the frontend dashboard, including repo URL, file path, key location, validation status, and IST timestamp. Supports the Dashboard page's real-time feed.

Depends on:#6#5
Waiting for dependencies
AI 75%
Human 25%
High Priority
1.5 days
Backend Developer
#10

Integrate Settings with Backend

To Do

As a user, I want the Settings page to save and load my GitHub API key from the backend so that my configuration persists across sessions. Wire the Settings (v2) frontend to the GitHub Key Settings API for save, update, and connection status display.

Depends on:#8#4
Waiting for dependencies
AI 80%
Human 20%
Medium Priority
0.5 days
Frontend Developer
#12

Build AI Assistant Page

To Do

As a user, I want to access an AI assistant interface so that I can ask questions about exposed key findings and learn about secure coding practices. Implement the dashboard/ai-assistant page frontend with a chat-style UI using the amber-scanner theme, wired to the AI Assistant API backend. Supports educational interactions for both Student/Developer and Educator/Trainer personas.

Depends on:#11#1
Waiting for dependencies
AI 80%
Human 20%
Medium Priority
1.5 days
Frontend Developer
#9

Integrate Dashboard with Backend

To Do

As a user, I want the Dashboard page to display live data from the backend so that I see real findings from the GitHub scanner. Wire the Dashboard (v2) frontend to the live findings WebSocket/SSE API, stats REST endpoint, and repo details endpoint. Handle loading, error, and empty states. Enable real-time amber pulse animation on new key detection.

Depends on:#3#7
Waiting for dependencies
AI 80%
Human 20%
High Priority
2 days
Frontend Developer
Landing design preview
Landing: View Overview
Dashboard: Monitor Findings
Dashboard: View Repo Details
Dashboard: View Stats Panel
Settings: Configure API Key
Dashboard: Guide Scan Session