Documentation
Master L'Amigo: Track friends, compare stats, get problem recommendations, export data, and sync solutions to GitHub.
⚡ Quick Start Guide
- Install: Add L'Amigo from the Chrome Web Store
- Setup: Enter your LeetCode username when prompted
- Add Friends: Start tracking friends using their username or profile URL
- Explore: Use the three tabs to view Friends, Compare stats, and configure Settings
💡 Tip: You can paste full LeetCode profile URLs - the extension extracts the username automatically!
1. Friends Tab
Your main dashboard for tracking up to 50 friends and viewing their LeetCode progress in real-time.
Managing Friends
To add a friend, type their username or paste their LeetCode profile URL in the input field, then press Enter or click the + button. Profiles load instantly with cached data and refresh in the background.
To remove a friend, hover over their card and click the trash icon, then confirm deletion. To refresh, click the individual refresh icon on any card, use the ↻ button to refresh all friends, or press R as a keyboard shortcut.
Sorting & Filtering
Use the Sort by dropdown to organize by Name, Problems Solved, or Last Submitted (default).
Caching & Rate Limits: Friend profiles are cached for 15 minutes to avoid triggering LeetCode's rate limits. Stale profiles automatically refresh in the background. Manual refresh available anytime.
2. Problem Recommendations
Discover problems your friends have solved but you haven't attempted yet. Learn from your peer group's solving patterns and stay motivated.
How It Works
The recommendation engine scans all your friends' recent submissions, filters out problems you've already solved, ranks by popularity (how many friends solved each problem), and returns the top 10 most-solved problems by your friend group.
Each recommended problem displays the problem title (clickable link to LeetCode), difficulty badge (Easy/Medium/Hard), the number of friends who solved it, and their names.
Pro Tip: The recommendation engine dynamically analyzes patterns across your entire friend group. As you add more friends, it fetches deeper solve history to provide more accurate, peer-based suggestions!
3. Compare Tab
Compare your performance against your friends with detailed metrics, difficulty breakdowns, and activity charts.
Features
The Compare tab displays side-by-side metrics including Total Problems Solved with visual bars, Easy/Medium/Hard breakdown showing difficulty distribution, current streak for consistency tracking, contest rating comparison, and global rank positions on LeetCode leaderboards.
Visual pie charts show each person's problem difficulty distribution using color coding (green for Easy, yellow/orange for Medium, red for Hard problems).
Activity timeline line graphs display submission activity over time, allowing you to spot activity spikes and lulls, compare consistency between users, and identify solving patterns.
How to Use
Switch to the Compare tab (or press 2), select friends from the dropdown to add them to comparison, and compare up to any number of friends simultaneously. Scroll down to view detailed charts and graphs.
Competitive Tip: Use the Compare tab for study groups or friendly competition. Metrics are color-coded – the highest values are highlighted for quick spotting!
4. LeetCode Profile Integration
L'Amigo injects native buttons directly into LeetCode profile pages for a seamless experience. No need to copy-paste usernames!
Direct Actions
When you visit any LeetCode user's profile page, L'Amigo adds two premium buttons to their sidebar:
- Track with L'Amigo: Instantly adds the user to your tracked friends list. If the user is already tracked, the button updates to show a checkmark status.
- Compare with Me: Opens a sleek side-by-side modal showing your stats vs theirs, including Contest Ratings and Topic-wise mastery.
Persistent Integration: Our injection engine is built to handle LeetCode's dynamic React UI. Even if the page re-renders, the L'Amigo buttons remain firmly in place and ready for action.
5. Settings Tab
Configure GitHub sync, manage your profile, toggle dark mode, export data, and customize auto-refresh settings.
General Settings
Update your LeetCode username for problem recommendations and profile tracking. Toggle Dark Mode between light and dark themes. Enable Notifications to get alerts when friends solve new problems. Configure Auto-Refresh with intervals of 15min, 30min, 1hr, or 2hr to keep friend data fresh automatically.
Export Data
Export your friends' data in CSV (simple format), Detailed CSV (comprehensive export), or JSON (raw data for developers). Access via the menu in the header → Export Data.
GitHub Sync Setup
Automatically sync all your accepted LeetCode solutions to a GitHub repository.
Go to GitHub
Settings → Developer Settings → Personal Access Tokens, click Generate new token
(classic), give it a name like "L'Amigo Sync", check the repo scope, and
generate/copy the token. Return to L'Amigo Settings tab, paste the token, enter your
repository in format username/repo-name, click Connect, then click Sync
with GitHub.
The sync engine dynamically fetches your complete historical submission data on the first run. For subsequent updates, it uses a fast incremental mode that only pushes new solves. Live progress tracking shows (X/Y) problems synced to your repository.
Repository Structure
repo-name/ ├── 1. Two Sum/ │ └── solution.py ├── 2. Add Two Numbers/ │ └── solution.cpp ├── 3. Longest Substring Without Repeating Characters/ │ └── solution.java └── ...
Privacy & Security: Your GitHub token is stored locally in Chrome's secure storage. It's never sent to any third-party server – only directly to GitHub's API. You can disconnect anytime to revoke access.
Clear All Data
Remove all stored friends, profiles, and settings. This action cannot be undone.
6. Keyboard Shortcuts
Navigate L'Amigo faster with built-in keyboard shortcuts.
Tab Navigation
- 1 → Friends tab
- 2 → Compare tab
- 3 → Settings tab
Actions
- R → Refresh all friends
- Esc → Close menus
Navigation (Friends Tab)
- J → Select next friend
- K → Select previous friend
Troubleshooting & FAQ
Common Issues
Extension Not Loading?
Navigate to chrome://extensions, click the Reload icon under L'Amigo. If
issue persists, toggle it off and back on.
GitHub Sync Failed?
Verify your Personal Access Token hasn't expired, ensure the token has repo scope, check
repository name format (username/repo-name), and confirm the repository exists with write
access.
Friend Profile Not Loading?
Double-check the username spelling, ensure their profile is public (private profiles can't be tracked), wait a few seconds for initial load, and try the refresh button on their card.
Data Seems Stale?
Profiles are cached for 15 minutes. Click the individual refresh icon on friend cards, use the batch refresh (↻) to update everyone, or press R keyboard shortcut.
Frequently Asked Questions
Is L'Amigo free?
Built for the community. 100% free and open-source with no premium tiers or tracking.
Security
All data is stored locally. Tokens and profiles are never sent to external servers.
Friend Limit
Track up to 50 friends. Optimized to maintain performance and respect API limits.
Auto-Refresh
Profiles update in the background. Customizable intervals available in settings.
Offline Support
Cached data remains accessible. Internet is only required for syncing new data.
Mobile Support
Currently desktop-only. Browser extensions are not yet natively supported on mobile Chrome.
Contribute & Support
L'Amigo is a community-driven project. Help us grow by starring the repo, reporting bugs, or submitting features!