WriteLogs
WriteLogs is an AI-powered VS Code extension that automatically tracks your coding sessions and provides intelligent time logging for productivity analysis and accurate work hour tracking.
Features
- Automatic Change Tracking: Monitors file edits in real-time without manual intervention
- Intelligent Diff Analysis: Tracks contextual code changes with minimal noise
- Secure Sync: Encrypted transmission of logs to your configured backend every 15 minutes
- Sidebar Dashboard: View sync status, last sync time, and manage your PAT key from the VS Code sidebar
- Subtle Notifications: Non-intrusive status bar updates keep you informed without interrupting your workflow
- Flexible Scheduling: Development mode for frequent syncing or production mode (15-minute intervals)
- Privacy-First: Only tracks diff metadata, not sensitive code content
Quick Start
- Install WriteLogs from the VS Code marketplace
- Open the WriteLogs sidebar: Click the WriteLogs icon in the Activity Bar (left sidebar)
- Set your PAT key:
- Click "⚙ Update PAT Key" in the sidebar, OR
- Run command
WriteLogs: Set PAT Key from Command Palette (Cmd/Ctrl + Shift + P)
- Enter your Personal Access Token (starts with
wrlg_)
- Start coding! WriteLogs automatically tracks your changes and syncs every 15 minutes
Monitor Your Activity
The WriteLogs sidebar features a modern, interactive webview with rich UI elements:
🎨 Rich Visual Interface:
- Color-coded status cards (green for success, red for errors, yellow for warnings)
- Real-time metrics with animated updates
- Professional badge indicators
- Progress feedback and loading states
🔐 Built-in PAT Management:
- Secure password input field right in the sidebar
- Instant validation feedback
- Masked PAT display (wrlg_**...**)
- One-click save and clear actions
📊 Live Sync Dashboard:
- Authentication Status: Connected/Not Configured with visual badges
- Last Sync: Timestamp with success/failure indicator
- Metrics Grid: Edits synced and next sync countdown
- Error Display: Detailed error messages when sync fails
⚡ Quick Actions:
- Sync Now: Button with cloud upload icon
- Save PAT: Inline form validation
- Clear PAT: Confirmation dialog for safety
✨ Smart UX Features:
- Welcome message for first-time users
- Inline validation with helpful error messages
- Auto-hiding success/error alerts
- Disabled states when PAT not configured
- Hover tooltips for guidance
Note: Everything is built into the sidebar - no need to switch between settings and command palette!## Extension Settings
This extension contributes the following settings:
writelogs.developmentMode: Enable frequent syncing for development (default: false)writelogs.devIntervalMs: Sync interval in development mode (default: 5 minutes)writelogs.productionIntervalMs: Sync interval in production mode (default: 15 minutes)
Note: API URL is pre-configured. No backend setup required on your end.
Commands
WriteLogs: Sync Logs - Manually trigger log synchronizationWriteLogs: Set PAT Key - Configure your Personal Access TokenWriteLogs: Clear PAT Key - Remove stored PAT key
Requirements
- VS Code 1.101.2 or higher
- Active internet connection for log synchronization
- Valid PAT key (provided by WriteLogs - no backend setup needed)
Privacy & Security
- PAT keys are stored securely in VS Code's workspace state
- Only diff metadata and timing information is transmitted
- No actual code content or sensitive data is sent to the backend
- All API communication uses HTTPS encryption
Troubleshooting
"Unauthorized (401)" Error
Your PAT key may be expired or invalid. Run WriteLogs: Set PAT Key to update it.
"Cannot connect to server" Error
Check your network connectivity. If the issue persists, the WriteLogs backend may be temporarily unavailable.
No logs being tracked
Ensure you're actively editing files (not just viewing) and that the files aren't in ignored directories like node_modules.
Known Issues
- Large binary files are automatically excluded from tracking
- Very rapid successive edits may be batched together for performance
Release Notes
0.0.1
Initial release with automatic change tracking and secure sync capabilities.
Following extension guidelines
Ensure that you've read through the extensions guidelines and follow the best practices for creating your extension.
Working with Markdown
You can author your README using Visual Studio Code. Here are some useful editor keyboard shortcuts:
- Split the editor (
Cmd+\ on macOS or Ctrl+\ on Windows and Linux).
- Toggle preview (
Shift+Cmd+V on macOS or Shift+Ctrl+V on Windows and Linux).
- Press
Ctrl+Space (Windows, Linux, macOS) to see a list of Markdown snippets.
Enjoy!
