Journily Extension

The Journily VS Code extension tracks your coding activity by monitoring file saves. It syncs with the Journily web app to provide insights into your coding habits and productivity.

Features

• Automatic Tracking: Tracks coding activity when you save files
• Project Recognition: Automatically detects your project name from Git configuration
• Stats Collection: Counts lines added/removed with each save
• Background Syncing: Automatically syncs activity to Journily API
• Offline Support: Caches activity when offline for later sync
• Activity Dashboard: View your recent coding activity directly in VS Code
• Simple Authentication: Connect with your Journily API token

Getting Started

1. Install the extension from the VS Code Marketplace
2. Open the Journily sidebar by clicking the Journily icon in the activity bar
3. Enter your Journily API token in the Authentication panel
4. Start coding! Your activity will be tracked automatically when you save files

Requirements

• VS Code 1.60.0 or higher
• An account on Journily with an API token

Extension Settings

This extension contributes the following settings:

• journily.token: Your Journily API token (stored securely)
• journily.trackingEnabled: Enable/disable activity tracking

Commands

The extension provides several commands:

• Journily: Set API Token: Configure your API token
• Journily: View Activity: Open the activity dashboard
• Journily: Toggle Tracking: Enable or disable tracking
• Journily: Clear Cache: Clear cached activity data
• Journily: Sync Now: Force sync pending activity logs
• Journily: Open Dashboard: Open the Journily sidebar

How Activity Tracking Works

When you save a file:

1. The extension detects the file path and project name
2. It calculates lines added and removed compared to the previous state
3. The activity data is sent to the Journily API
4. If offline, the data is cached locally and synced later

Privacy

• No code content is ever transmitted, only metadata (filenames, line counts)
• You can pause tracking at any time from the status bar or settings
• You can clear all cached data with the "Clear Cache" command

Development

Building the Extension

# Install dependencies
pnpm install

# Compile the TypeScript code
pnpm run compile

# Watch for changes during development
pnpm run watch

Running the Extension

Press F5 in VS Code to launch a new window with your extension loaded.

Release Notes

0.0.1

• Initial release
• File save tracking
• Activity dashboard
• Token authentication
• Offline caching

Following extension guidelines

Ensure that you've read through the extensions guidelines and follow the best practices for creating your extension.

• Extension Guidelines

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.

For more information

• Visual Studio Code's Markdown Support
• Markdown Syntax Reference

Enjoy!