Track. Analyze. Improve.
A full-stack developer analytics platform — VS Code extension + Django dashboard.
ACLAS (Adaptive Coding Lifecycle Analytics System) is a self-hosted developer productivity tracker built as a university project. It consists of:
- 🔌 VS Code Extension — silently tracks your keystrokes, file activity, lines added/deleted, and active vs idle time
- 🖥️ Django Backend — REST API that ingests telemetry heartbeats and stores them securely per user
- 📊 Analytics Dashboard — server-rendered UI with real-time charts, session history, and API token management
- ⌨️ Real-time keystroke tracking with 30-second heartbeat intervals
- 📁 Project name = filename.extension (e.g.
tracker.ts,views.py) - 💤 Idle detection — skips heartbeats when no typing occurs
- ⏱️ Active vs Idle time tracked per session
- 🔔 Toast warnings after 2 min idle; auto-discontinues after 6 min
- 🛑
Ctrl+Shift+P→ ACLAS: Stop Tracking command - 🔑
Ctrl+Shift+P→ ACLAS: Enter API Token to connect to your dashboard
- 🔐 Email + Google OAuth authentication (via
django-allauth) - 🧩 Token-based API authentication (Django REST Framework)
- 🗂️ Per-user telemetry storage with full session history
- 👥 Role-based access: Developer / Manager
- 🛡️ CSRF protection, duplicate-account prevention
- 🌑 Synthetix Dark theme — VS Code inspired glassmorphism
- 📈 6 stat cards: Events, Lines Added/Deleted, Active Time, Idle Time, Total Time
- 🍩 Chart.js charts: Top Projects (bar) + Language Distribution (doughnut)
- 🔍 Stats page with live search + language filter
- ⚙️ Settings page with API token display + profile management
- ✨ Subtle entrance animations and hover effects
ACLAS calculates a real-time developer Stress Score from passive VS Code telemetry using this exact linear weighted-sum formula (as implemented in aclas_backend/analytics/views.py):
raw = (
self.errors * 3 + # General IDE / runtime errors
self.repeated_errors * 5 + # Persistent same-error loops
self.build_failures * 4 + # Compile / build crashes
self.file_switches * 1 + # Context / navigational churn
self.undo_count * 2 + # Ctrl+Z hesitation & corrections
self.terminal_errors * 3 # Shell / CLI execution failures
)
stress_score = min(100, raw)Start the server locally and add your screenshots here
| Dashboard | Login | Stats |
|---|---|---|
![]() |
![]() |
![]() |
┌─────────────────────┐ Heartbeat POST ┌──────────────────────┐
│ VS Code Extension │ ───────────────────────────▶ │ Django REST API │
│ (aclas-vscode- │ /api/heartbeats/ │ TokenAuthentication│
│ master/) │ Authorization: Token <key> │ │
└─────────────────────┘ └──────────┬───────────┘
│
SQLite DB
│
┌──────────▼───────────┐
│ Django Templates │
│ Dashboard / Stats / │
│ Settings / Auth │
└──────────────────────┘
- Python 3.10+
- Node.js 18+
- VS Code
cd aclas_backend
# Create and activate virtual environment
python -m venv venv
venv\Scripts\activate # Windows
# source venv/bin/activate # macOS/Linux
# Install dependencies
pip install django djangorestframework django-allauth
# Run migrations
python manage.py migrate
# Create a superuser (for admin panel)
python manage.py createsuperuser
# Start the server
python manage.py runserverVisit → http://127.0.0.1:8000/
- Create a project at console.cloud.google.com
- Enable the Google Identity API
- Create OAuth credentials → Web App
- Redirect URI:
http://127.0.0.1:8000/accounts/google/login/callback/
- Redirect URI:
- In Django Admin → Social Applications → Add Google app with your Client ID + Secret
cd aclas-vscode-master
# Install dependencies (use cmd.exe on Windows)
npm.cmd install
# Compile
npm.cmd run compile- Open
aclas-vscode-masterin VS Code - Press F5 to launch the Extension Development Host
- Press
Ctrl+Shift+P→ ACLAS: Enter API Token - Paste the token from your dashboard (
http://127.0.0.1:8000/)
ACLAS/
├── aclas_backend/ # Django project
│ ├── aclas/ # Core settings & URLs
│ ├── analytics/ # Dashboard views, charts, templates
│ │ ├── static/analytics/ # aclas.css + aclas.js (design system)
│ │ └── templates/ # All HTML pages
│ └── telemetry/ # Heartbeat API, models, serializers
│
└── aclas-vscode-master/ # VS Code Extension
└── src/
├── extension.ts # Entry point, command registration
├── tracker.ts # Core tracking + idle logic
└── api.ts # HTTP heartbeat sender
Headers:
Authorization: Token <your-api-token>
Content-Type: application/json
Body:
{
"project_name": "tracker.ts",
"language": "typescript",
"lines_added": 12,
"lines_deleted": 3,
"active_seconds": 28,
"idle_seconds": 2
}Response: 201 Created
| Layer | Technology |
|---|---|
| Backend Framework | Django 6 + Django REST Framework |
| Authentication | django-allauth (Email + Google OAuth) |
| Database | SQLite (dev) / PostgreSQL (prod) |
| Frontend | Django Templates + Vanilla JS + Chart.js |
| CSS | Custom design system (Synthetix Dark) |
| VS Code Extension | TypeScript + Webpack |
| HTTP Client (plugin) | got 14 |


