TaskPilot is a browser extension prototype for safer, faster AI work. It combines prompt refinement, document-aware highlight actions, security scanning, model recommendation, and legal-risk review in one extension surface.
This repository is organized as a portfolio-ready prototype. The Chrome extension is the primary product surface. The TaskPilot_App directory contains an experimental Apple desktop companion and should be treated as optional.
If you are reviewing this project quickly, start with Reviewer Guide, then inspect manifest.json, selection-bubble.js, model-advisor.js, and legal-review/scanEngine.js.
- Refine: improves prompts, evaluates prompt complexity, and recommends a cost-aware model for the task.
- Flow: turns selected text into quick actions such as rewrite, summarize, explain, sources, notes, and follow-up prompts.
- Shield: scans AI prompts and page content for sensitive information, security risks, and governance signals.
- Clarity: reviews legal writing for unverified cases, unsupported legal claims, citation problems, and high-risk legal drafting issues.
| Path | Purpose |
|---|---|
manifest.json |
Chrome extension permissions, host access, content scripts, and side panel setup. |
background.js |
Extension orchestration, auth helpers, network routing, and shared services. |
sidebar.html, sidebar.js |
Persistent TaskPilot side panel UI. |
selection-bubble.js |
Flow and Refine inline UI attached to page selections and AI composer surfaces. |
factcheck-content.js |
Page-bound fact-checking and source-review overlay. |
security-tab.js, security-dashboard.* |
Shield security scan UI and dashboard surfaces. |
model-advisor.js |
Refine model recommendation logic for prompt complexity and cost-aware routing. |
legal-review/ |
Clarity legal-risk scanner, issue model, panel, settings, storage, and tests. |
ui/ |
Shared extension UI helpers. |
TaskPilot_App/ |
Optional Apple desktop companion prototype. |
docs/ |
Architecture, configuration, and portfolio cleanup notes. |
- Clone the repository.
- Open Chrome and go to
chrome://extensions. - Enable Developer mode.
- Click Load unpacked and select this repository root.
- Pin TaskPilot from the extensions menu and open the side panel.
For Google Docs features, configure the OAuth client ID locally before loading the extension. See Configuration.
This repo has no required npm dependencies for the current checks.
npm run checkThe check script syntax-checks the main extension files and runs the Clarity scan-engine fixture tests.
- Do not commit local OAuth clients, Supabase keys, OpenAI keys, or packaged extension builds.
.env,.env.*,.zip,.crx,.pem,.DS_Store, and local tool artifacts are ignored.- The public source uses placeholder configuration for the optional Apple desktop companion.
- Advanced review features that send document text to a model provider should remain opt-in and clearly labeled in the UI.
- Some extension files are large and are candidates for future modularization.
- Google Docs OAuth and Supabase-backed account features require local configuration.
TaskPilot_App/is an optional desktop companion prototype, not the main review surface.
The strongest way to share this project is as a focused extension portfolio repo. Keep screenshots, a short demo clip, and a clear explanation of each module in the README or docs/ folder. Avoid committing local builds, generated zip files, or machine-specific files.