Configuration

Configure AutoTrack to your needs with API keys, environment variables, and custom settings.

API Keys

API keys are used to authenticate the Chrome Extension and npm package with your dashboard.

Generate API Key

1. Log in to app.autotrack.dev
2. Go to Dashboard → API Key
3. Click "Generate New API Key"
4. Copy the key immediately (you can only see it once!)
5. Store it securely

Using API Key

Chrome Extension

The Chrome Extension automatically asks for your credentials on first use. You don't need to manually enter the API key.

npm Package

Run the init command and enter your credentials:

autotrack init

Revoke API Key

If your API key is compromised:

1. Go to Dashboard → API Key
2. Click "Revoke API Key"
3. The old key is invalidated
4. Generate a new key
5. Update your extension/package with the new key

Environment Variables

The npm package can be configured with environment variables.

Dashboard URL

By default https://app.autotrack.dev/api/worklog is used. You can change this:

export WORKLOG_DASHBOARD_URL="https://custom.domain.com/api/worklog"

Auto-Submit

By default entries are automatically sent to the dashboard. You can disable this:

export WORKLOG_AUTO_SUBMIT="false"

If you disable this, entries are only stored locally. You'll need to manually synchronize them.

Default Project Name

By default the repository name is used as project. You can set a custom name:

export WORKLOG_PROJECT="my-custom-project-name"

Complete .bashrc / .zshrc Setup

Add these lines to your ~/.bashrc or~/.zshrc:

# AutoTrack Configuration
export WORKLOG_DASHBOARD_URL="https://app.autotrack.dev/api/worklog"
export WORKLOG_AUTO_SUBMIT="true"
export WORKLOG_PROJECT="my-project"

# Optional: Add custom git user info
export GIT_AUTHOR_NAME="Your Name"
export GIT_AUTHOR_EMAIL="your.email@example.com"

After adding, reload your shell: source ~/.bashrc orsource ~/.zshrc

Git Hooks Configuration

Hooks Location

Git hooks are installed in:

~/.git-templates/hooks/

These hooks are automatically copied to every new git repository you create.

Reinstall Hooks

If the hooks aren't working, reinstall them:

npx @svenjens/mcp-autotrack-server postinstall

Disable Hooks (Per Repository)

If you want to disable hooks for a specific repository:

cd your-repository rm .git/hooks/post-commit

Chrome Extension Settings

Default Duration

In the extension popup you can set a default duration that's automatically filled in for new entries.

1. Open the extension popup
2. Click the settings icon (⚙️)
3. Set your preferred default duration
4. Click "Save"

Auto-fill Project

The extension automatically detects the project based on the URL. You can add custom mappings:

1. Open the extension popup
2. Click the settings icon (⚙️)
3. Go to "Project Mappings"
4. Add custom URL → Project mappings

Notifications

You can enable or disable notifications:

1. Open the extension popup
2. Click the settings icon (⚙️)
3. Toggle "Show Notifications"
4. Click "Save"

Dashboard Settings

Profile Settings

Update your profile information:

1. Log in to app.autotrack.dev
2. Go to Profile (top right)
3. Update your name, email, timezone, etc.
4. Click "Save Changes"

Email Report Settings

Configure automatic email reports (Pro feature):

1. Go to Dashboard → Email Reports
2. Enable "Automatic Reports"
3. Configure:
   • Frequency (weekly, monthly)
   • Recipients (email addresses)
   • Report format
4. Click "Save Settings"

Timezone Settings

Make sure your timezone is set correctly for accurate timestamps:

1. Go to Profile → Settings
2. Select your timezone
3. Click "Save"

Advanced Configuration

Custom API Endpoint

For enterprise users with self-hosted version:

# Set custom API endpoint
export WORKLOG_API_ENDPOINT="https://your-domain.com/api"

# Set custom dashboard URL
export WORKLOG_DASHBOARD_URL="https://your-domain.com"

Debug Mode

Enable debug logging:

export WORKLOG_DEBUG="true"

This shows extra logging in the terminal and browser console.

Offline Mode

Work completely offline (entries are only stored locally):

export WORKLOG_OFFLINE_MODE="true"

Troubleshooting

Environment variables don't work

1. Check if you've added them to ~/.bashrc or~/.zshrc
2. Reload your shell: source ~/.bashrc
3. Verify with: echo $WORKLOG_AUTO_SUBMIT
4. Restart your terminal completely

API key doesn't work

• Check if the key was copied correctly (no extra spaces)
• Verify that the key hasn't been revoked
• Generate a new key and try again
• Check if you're logged in to the correct account