Quick Start Guide

Get started with automatic time tracking in 2 minutes. Choose your method!

Super Simple!

You just need to choose between the npm package (for automatic git tracking) or the Chrome Extension (for manual entries). Or use both!

Option 1: npm Package (Automatic via Git)

Install once and every git commit is automatically logged. Zero manual work!

Install the npm package

Open your terminal and install the package globally:

npm install -g @svenjens/mcp-autotrack-server

This automatically installs the git hooks that activate worklog tracking.

Set up authentication

Run the init command to link your account:

autotrack init

You'll be asked for your credentials. These are securely stored locally.

Commit your code

Work as usual! Use conventional commit format:

git commit -m "feat: implement user authentication system"
git commit -m "fix: resolve API timeout issues"
git commit -m "refactor: improve dashboard structure"

Entries are automatically sent to your dashboard! 🎉

Option 2: Chrome Extension (Manual Entries)

Perfect for quickly adding a time entry from your browser.

Install the Chrome Extension

Download and install the AutoTrack extension from the Chrome Web Store:

Install from Chrome Web Store

Or install unpacked for development (see the full guide)

Log in with your account

Click the extension icon in your Chrome toolbar and log in with your AutoTrack credentials.

Don't have an account yet? Sign up here - it's free!

Create your first entry

Click the extension icon
The project is automatically detected
Fill in the task description
Select the duration
Click "Add to Autotrack"

That's it! 🎉

Pro Tip

Use both methods! The npm package for automatic tracking of your commits, and the Chrome extension for ad-hoc entries or meetings.

Check Your Dashboard

Now that you've logged entries, view them in the dashboard:

Go to app.autotrack.dev
Log in with your account
You'll see all your worklog entries with project, task, and duration
Filter by date, project, or task
Export to CSV or generate reports

Next Steps

Chrome Extension Guide

All features and keyboard shortcuts

npm Package Guide

Advanced configuration and commands

Dashboard Guide

View entries, generate reports

Configuration

API keys and environment variables

Having Issues?

Check the troubleshooting guide if you run into any problems.