Cervyn

Automated coding activity tracker that builds your portfolio at cervyn.com as you code.

What It Does

Cervyn tracks your coding activity in VS Code and syncs it to your portfolio in real-time. Track languages, frameworks, projects, and coding patterns without manual updates.

Key Features:

• Automatic event tracking (edits, saves, git, terminal, debug sessions)
• Privacy-first: tracks metadata only by default (no code content)
• Works offline with automatic sync
• Low overhead (<1% CPU usage)
• Compatible with VS Code, Cursor, Windsurf, Continue.dev, and other VS Code-based editors

Quick Start

1. Install

Search for "Cervyn" in VS Code Extensions, or install via:

code --install-extension cervyn.cervyn-event-logger

Or install directly:

• VS Code Marketplace
• Works with: VS Code, Cursor, Windsurf, Continue.dev, and all VS Code forks

2. Sign In

1. Open Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
2. Run Cervyn: Sign In
3. Create account at cervyn.com to get your API key
4. Paste API key when prompted

3. Start Coding

The extension runs automatically. Check status in the bottom-right status bar (🟢 Cervyn).

What Gets Tracked

Always Tracked (Default)

• Files: Paths, names, languages (e.g., src/components/Button.tsx)
• Events: File edits, saves, creates, deletes, renames
• Git: Commits, pushes, pulls, branch changes
• Terminal: Command execution, session duration
• Debug: Debug sessions, breakpoints
• Diagnostics: Errors, warnings, linting issues
• Time: Active coding time, project duration

Never Tracked

• Code content (unless explicitly enabled)
• Keystrokes or clipboard content
• Files matching ignore patterns (.env, node_modules, .git, etc.)

Optional (Opt-In Only)

• Code Content: Actual code snippets for portfolio showcase
• AST Analysis: Code quality and complexity metrics
• Workspace Indexing: Full project analysis on startup

Commands

Open Command Palette (Cmd+Shift+P / Ctrl+Shift+P):

Configuration

All settings are optional. Access via Settings (Cmd+, / Ctrl+,) → Search "Cervyn".

Tracking Toggles

{
  "cervyn.eventLogger.enabled": true,
  "cervyn.eventLogger.trackCodeEdits": true,
  "cervyn.eventLogger.trackFileOperations": true,
  "cervyn.eventLogger.trackFileSaves": true,
  "cervyn.eventLogger.trackGit": true,
  "cervyn.eventLogger.trackTerminal": true,
  "cervyn.eventLogger.trackDebug": true,
  "cervyn.eventLogger.trackDiagnostics": true,
  "cervyn.eventLogger.trackTasks": true
}

Privacy Settings

{
  "cervyn.eventLogger.trackCodeContent": false,  // Opt-in only
  "cervyn.eventLogger.ignoredPaths": [
    "**/node_modules/**",
    "**/.git/**",
    "**/.env*",
    "**/secrets/**",
    "**/dist/**",
    "**/build/**"
  ]
}

Performance

{
  "cervyn.eventLogger.batchSize": 20,        // Events per batch
  "cervyn.eventLogger.flushInterval": 5000,  // Send interval (ms)
  "cervyn.eventLogger.debounceMs": 2000      // Duplicate event debounce (ms)
}

Advanced (Opt-In)

{
  "cervyn.eventLogger.enableASTChunking": false,         // Code analysis
  "cervyn.eventLogger.sendChunksToDatabase": false,      // Send analysis to server
  "cervyn.eventLogger.indexWorkspaceOnStartup": false    // Index project on startup
}

Privacy & Security

• No code by default: Only file paths and metadata tracked
• Automatic exclusions: Sensitive files (.env, secrets) automatically ignored
• Local-first: Events queue locally, sync when connected
• GDPR compliant: Full data deletion available at cervyn.com/settings
• Row-level security: Database enforces user data isolation

Troubleshooting

Extension not tracking?

1. Check status bar shows "🟢 Cervyn" (green)
2. Run Cervyn: Show Config to verify API key is set
3. Run Cervyn: Test Connection to verify connectivity
4. Enable debug mode: Settings → cervyn.eventLogger.debug → true
5. View logs: View → Output → "Cervyn Event Logger"

Events not appearing?

• Events batch every 5 seconds by default
• Run Cervyn: Flush Events Now to send immediately
• Check you're signed into the correct account at cervyn.com

Need help?

[TODO: Add support email/Discord/GitHub issues link]

Compatibility

Links

• Website: [https://cervyn.com/]
• Marketplace: [https://marketplace.visualstudio.com/items?itemName=cervyn.cervyn-event-logger]

License

MIT License - see LICENSE file.