UI Guide¶
The Foil dashboard is a local web app served by the foil server on http://localhost:9090. It mirrors the CLI surface with browsable views for projects, findings, and deep-dive investigations.
Launch it from the tray app (Open dashboard) or by navigating directly to localhost:9090 after foil server start.
How do I…¶
- Scan a project — step-by-step walkthrough, including how to run a deep scan and export a PDF report (both only reachable from Project detail)
Sections¶
| Page | URL | Purpose |
|---|---|---|
| Dashboard | / |
Overview — recent scans, latest HIGH finding, project switcher |
| Projects | /projects |
List and register projects, kick off scans |
| Project detail | /projects/detail |
Per-project workspace: scan, code map, findings, investigations, PDF report |
| Findings | /findings |
Browse findings with severity / file / text filters |
| Deep-dive | /findings/deep-dive |
Phase 6 agentic investigation details (Developer edition) |
| Models | /models |
Download, activate, delete LLM models |
| Logs | /logs |
Live tail of server, engine, and scan logs |
| Settings | /settings |
App configuration, password, data management |
| Login | /login |
Local auth for the dashboard |
Layout conventions¶
- Left rail — project switcher and section nav
- Top bar — server status pill, model chip, quick actions
- Content — section-specific cards and tables
- Density — compact by default, designed to fit a laptop without scrolling
First-time setup¶
On a fresh install, set an admin password at /login (or via foil server resetpw), then register your first project from the Projects page. Everything else flows from there.