npm Package

Automatic time tracking via git commits. Install once and forget about it!

How It Works

1. Install the package globally
2. Setup authentication (one-time)
3. Commit your code with conventional format
4. Automatic sync - entries are sent directly to dashboard!

Installation

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

autotrack init

Usage

Conventional Commit Format

Use the conventional commit format for best results. The package automatically recognizes the type of change:

git commit -m "feat: implement user authentication system"
git commit -m "feat(api): add endpoint for worklog entries"

git commit -m "fix: resolve API timeout issues"
git commit -m "fix(auth): correct JWT token expiration"

git commit -m "refactor: improve dashboard component structure"
git commit -m "refactor(utils): simplify date formatting"

git commit -m "docs: update API documentation"
git commit -m "test: add unit tests for auth service"
git commit -m "chore: update dependencies"

Automatic Sync

After each commit, entries are automatically sent to your dashboard:

1. You make a commit with conventional format
2. Git post-commit hook is triggered
3. Entry is created with project, task, and duration
4. Entry is directly sent to dashboard via API
5. You see the entry in your dashboard

Manual Commands (Optional)

Check Status

Check if everything is configured correctly:

npx @svenjens/mcp-autotrack-server status

Log Work Manually

Add an entry manually:

npx @svenjens/mcp-autotrack-server log --task="Manual work entry" --duration="1h"

Estimate Duration

Estimate a duration based on code changes:

npx @svenjens/mcp-autotrack-server estimate --linesChanged=50 --changeType=feature

Configuration (Optional)

You can customize behavior with environment variables:

# Dashboard URL (default: https://app.autotrack.dev/api/worklog)
export WORKLOG_DASHBOARD_URL="https://app.autotrack.dev/api/worklog"

# Auto-submit to dashboard (default: true)
export WORKLOG_AUTO_SUBMIT="true"

# Default project name (optional, otherwise repo name is used)
export WORKLOG_PROJECT="my-project"

More about configuration in the Configuration guide.

Duration Estimation Logic

The package uses a smart algorithm to estimate duration:

Troubleshooting

Git hooks not installed

Reinstall the git hooks:

npx @svenjens/mcp-autotrack-server postinstall

No automatic entries

1. Check if you're in a git repository
2. Use conventional commit format (feat:, fix:, etc.)
3. Run status check: npx @svenjens/mcp-autotrack-server status
4. Check the git hooks folder: ls -la .git/hooks/

Entries not visible in dashboard

1. Check if WORKLOG_AUTO_SUBMIT is set to true
2. Verify your authentication: run autotrack init again
3. Check your internet connection
4. Look in the browser console of your dashboard for errors

Dashboard not reachable

If the dashboard is temporarily unreachable, entries are stored locally. They will be automatically synced on your next commit when the connection works again.

Uninstall

If you want to remove the package:

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

This removes the package and all git hooks.