The Downloads page provides comprehensive monitoring of all file downloads initiated by the browser, including downloads from agent sessions. Track file types, sizes, sources, and security status.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/ContextFort-AI/ContextFort/llms.txt
Use this file to discover all available pages before exploring further.
Overview
The Downloads page displays:- Total downloads across all sessions
- Completed downloads that finished successfully
- Dangerous downloads flagged by Chrome’s security checks
- Download history with full details and pagination
Download tracking captures all browser downloads, not just those from agent sessions.
Statistics Cards
Three stat cards at the top provide quick insights:Total Downloads
- Icon: Download icon
- Value: Total number of downloads (all time)
- Description: “All time”
Completed
- Icon: File icon
- Badge: Green (success variant)
- Value: Number of successfully completed downloads
- Description: “Successfully downloaded”
Dangerous
- Icon: Alert triangle icon
- Badge: Red (error variant)
- Value: Number of downloads flagged as potentially harmful
- Description: “Potentially harmful”
Download History Table
The main table displays all downloads with detailed information.Table Columns
| Column | Description |
|---|---|
| Type | Emoji icon representing file category |
| Time | Download time in HH:MM:SS format (24-hour) |
| Date | Download date as MMM DD |
| Filename | File name and source hostname |
| Size | Human-readable file size |
| Category | File category badge (document, image, etc.) |
| Status | Safety status (Safe or Danger badge) |
File Categories
Downloads are automatically categorized:Documents
📄 PDF, DOC, TXT filesBadge: Blue
Spreadsheets
📊 XLS, XLSX, CSV filesBadge: Green
Presentations
📽️ PPT, PPTX filesBadge: Purple
Images
🖼️ PNG, JPG, GIF, SVG filesBadge: Pink
Videos
🎬 MP4, AVI, MOV filesBadge: Red
Audio
🎵 MP3, WAV, OGG filesBadge: Indigo
Archives
📦 ZIP, TAR, GZ, RAR filesBadge: Yellow
Executables
⚙️ EXE, DMG, APP filesBadge: Orange
Code
💻 JS, PY, HTML, CSS filesBadge: Cyan
Data
📊 JSON, XML, SQL filesBadge: Teal
Other
📁 Uncategorized filesBadge: Gray
Download Details
Each download row displays:Filename and Source
- Top line: Full filename (truncated if too long, hover to see full name)
- Bottom line: Hostname of the download source (e.g.,
github.com)
Time Information
- Time: 24-hour format (e.g.,
14:30:45) - Date: Abbreviated month and day (e.g.,
Jan 15)
File Size
Human-readable format:123 B- Bytes4.5 KB- Kilobytes12.3 MB- Megabytes1.2 GB- Gigabytes
Safety Status
- Green “Safe” badge: Download passed Chrome’s security checks
- Red “Danger” badge with alert icon: Download flagged as potentially harmful
Pagination
The table shows 20 downloads per page.Pagination Controls
- Previous button: Go to previous page (disabled on page 1)
- Page indicator: “Page X of Y”
- Next button: Go to next page (disabled on last page)
- Results summary: “Showing X to Y of Z downloads”
Refreshing Data
The page auto-refreshes every 5 seconds to capture new downloads. You can also manually refresh:- Click the Refresh button in the top-right
- Refreshing resets to page 1
- Current downloads are reloaded from Chrome storage
Auto-refresh ensures you see new downloads as they happen, without manual intervention.
Empty States
No Downloads Yet
If you see this message:- No downloads have been tracked
- Chrome storage was cleared
- The extension hasn’t captured any downloads yet
- Download icon
- “No downloads yet” heading
- “Download activity will appear here” message
Download Tracking
Downloads are tracked using Chrome’sdownloads API:
- Background script listens for
chrome.downloads.onCreated - Download metadata is captured:
- Filename, URL, referrer
- File size, MIME type, extension
- Start time, state, danger status
- Categorization based on extension
- Download is saved to
chrome.storage.local(key:downloadRequests) - Dashboard loads and displays the data
Use Cases
Security Auditing
Review downloads to:- Verify no malicious files were downloaded
- Check for unexpected executable downloads
- Audit file sources and types
Data Exfiltration Detection
Monitor for:- Large downloads of data files
- Downloads from unexpected domains
- Multiple downloads in quick succession
Compliance Reporting
Track:- What files agents downloaded
- When downloads occurred
- File types and categories
Best Practices
Investigate dangerous downloads
Always review red-flagged downloads immediately. Delete if suspicious.
Check unknown sources
If a download is from an unfamiliar domain, investigate before opening the file.
Technical Details
The Downloads page:- Loads from
chrome.storage.local(key:downloadRequests) - Auto-refreshes every 5 seconds via
setInterval - Shows 20 items per page
- Categorizes files based on extension mapping
- Highlights dangerous downloads with red background
- Uses Chrome’s
downloadsAPI danger and state flags
Danger States
Chrome’s download API can flag downloads as:- safe: No threat detected
- dangerous: Known malware or virus
- uncommon: Rarely downloaded, potentially risky
- dangerous_content: Harmful content detected
- dangerous_host: Downloaded from known malicious host
- potentially_unwanted: PUP (Potentially Unwanted Program)
Next Steps
Review Sessions
See which sessions initiated downloads
Check Domains
Review domains where downloads originated