llms.txt
Compare with other sites' llms.txt files →# Track Your Time
> Free, open-source time tracking. Use the hosted service at trackyourtime.dev, or run the same app on your own server. A timer in the browser, a desktop app, the Mac menu bar and a phone app keeps working offline and syncs across devices, and tracked hours become reports and invoices: a plain PDF, a ZUGFeRD PDF or an XRechnung file.
Track Your Time is for freelancers, consultants and small studios who bill clients by the hour. The code is on GitHub at https://github.com/trebeljahr/trackyourtime. The main app and server use AGPL-3.0-or-later. The Raycast extension, including its copied core/shared code, uses MIT. A hosted instance runs at https://trackyourtime.dev. It is free, has no paid plan, and runs the same code as a self-hosted server.
**What it does today**
- Your data can stay on your own server. One Docker Compose file runs five containers on one server and one domain: the API, the web app, MongoDB, Redis and Caddy. Caddy gets the HTTPS certificate from Let's Encrypt.
- You can export a whole workspace as JSON or CSV at any time. A CSV from another tool imports with a preview and a one-step undo.
- The timer is where you already work. There is a desktop app for macOS, Windows and Linux, a Chrome extension, a Raycast extension with a menu bar clock and a start/stop hotkey, and iPhone and Android apps.
- The web app, the desktop app, the extensions and the phone apps keep tracking without a connection. They send the queued changes when the connection returns.
- Every client app works with the hosted service and with a self-hosted server. The desktop app, the Chrome extension and the phone apps let the person choose a server before signing in, and a self-hosted server accepts their store builds by default (`TRUST_STORE_APPS=true`). The Raycast extension has API URL and Web App URL preferences.
- Recent entries, pinned favorites and description autocomplete fill in earlier details. A maximum timer length stops a forgotten timer or emails a reminder. The Chrome extension and the desktop app can suggest entries from browsing or app activity. Both are off by default, and the activity itself stays on the computer.
- Workspaces have members, email or link invitations, three roles (owner, admin, member) and per-member visibility of colleagues' time and money. Reports group by member. Optional timesheet approval locks a submitted or approved week; it needs MongoDB running as a replica set.
- Projects can carry a budget in hours or money, shown as progress.
- Settings → Data → Move to another server copies a workspace between two servers, hosted to self-hosted or back.
- A timer you stop on one device stops on every other open device at once, over a WebSocket.
- Each project and each member can have an hourly rate. A new entry takes the project's rate first, then the member's, then the workspace default. Reports show totals by project, client, task, tag, day, week or month, or list every entry. Both views export to CSV and PDF.
- An invoice collects a client's unbilled billable hours. It downloads as a plain PDF, as a ZUGFeRD PDF or as an XRechnung XML file. An hour on an invoice cannot be billed again.
- Every install has every feature. There are no paid plugins and no premium tier.
- The server has a REST API at `/api/v1` with an OpenAPI document, and sends webhooks signed with HMAC-SHA256.
- Self-host images are published through v0.3.0 for amd64 and arm64.
- An MCP server lets an AI assistant start and stop timers, log past time and list entries. It also lists and creates clients, projects, tasks and tags, and reads summary reports. Install it with npx -y trackyourtime-mcp. It is published on npm and the official MCP Registry and has no invoice tools.
**Current limits**
- There is no client login or shared report link, and no budget alert.
- Desktop version 0.3.0 is public for macOS, Windows and Linux on GitHub Releases (https://github.com/trebeljahr/trackyourtime/releases/latest). macOS is also available from Homebrew: brew install --cask trebeljahr/tap/track-your-time (https://github.com/trebeljahr/homebrew-tap). No store lists the desktop app.
- A self-hosted instance has open sign-up. The application has no setting to close registration. The self-hosting guide lists workarounds at the proxy.
- The Chrome extension is in the Chrome Web Store (https://chromewebstore.google.com/detail/track-your-time/opibnndhibnigcfgfbgbipakadhnbjfi). Firefox 0.3.0 is public on Firefox Add-ons (https://addons.mozilla.org/firefox/addon/track-your-time/). The Raycast extension and the phone apps are not in any store yet.
**How to self-host**
Point a domain at a Linux server with Docker, clone the repository, copy `.env.selfhost.example` to `.env`, and set `APP_DOMAIN` and `BETTER_AUTH_SECRET`. Then run `docker compose -f docker-compose.selfhost.yml up -d`. The self-hosting guide below has every command, the expected output, backups, upgrades and troubleshooting.
## Start here
- [Choosing a self-hosted time tracker](https://trackyourtime.dev/docs/choosing-a-self-hosted-time-tracker.md): Three kinds of self-hosted time tracker, what each one is good at, when to pick it, and what Track Your Time cannot do yet.
- [Self-hosting guide](https://trackyourtime.dev/docs/self-hosting.md): Run Track Your Time on one server with one domain and Docker Compose: install, first account, email, backups, upgrades and troubleshooting.
## Invoicing
- [E-invoices (XRechnung and ZUGFeRD)](https://trackyourtime.dev/docs/e-invoices.md): Send an invoice as XRechnung XML or as a ZUGFeRD PDF with the invoice data inside. Complete your business profile, add your client's billing details and fix what the check reports.
## Apps
- [Desktop app](https://trackyourtime.dev/docs/desktop.md): Install the Track Your Time desktop app on macOS, Windows or Linux, sign in to the hosted service or your own server, and learn how each version updates.
## AI assistants
- [MCP server](https://trackyourtime.dev/docs/mcp.md): Start and stop timers, log time, list entries, manage clients, projects, tasks and tags, and summarise hours from Claude or any MCP client, on the hosted service or your own server.
## REST API
- [REST API](https://trackyourtime.dev/docs/api.md): The public REST API at /api/v1 — base URL, response envelope, cursor pagination, and what an API token can and cannot reach.
- [Authentication](https://trackyourtime.dev/docs/api/authentication.md): Minting an API token, the scope table, how a token's visibility is resolved, and what revoking one does.
- [Errors](https://trackyourtime.dev/docs/api/errors.md): RFC 9457 problem+json error bodies, the full slug table, and what each status means on this API.
- [OpenAPI document](https://api.trackyourtime.dev/api/v1/openapi.json): The machine-readable description of every /api/v1 route, served by the hosted API.
## Web pages
- [Self-hosted time tracking](https://trackyourtime.dev/self-hosting/): Server requirements, installation, backups, upgrades and operational limits.
- [Time tracking API](https://trackyourtime.dev/api/): REST tokens, OpenAPI, signed webhooks and MCP setup.
- [Invoices from tracked hours](https://trackyourtime.dev/invoicing/): Historical rates, unbilled entries, payments and e-invoice formats.
- [Offline time tracking](https://trackyourtime.dev/offline/): Queues, reconnect behavior and protection of unsent work across clients.
- [Reports](https://trackyourtime.dev/time-reports/): Filters, grouping, named views and CSV or PDF export.
- [Freelancer workflow](https://trackyourtime.dev/freelancers/): Client setup, daily review and monthly billing.
- [Studio and agency workflow](https://trackyourtime.dev/studios/): Team workspaces, rates, visibility and approvals.
- [Developer workflow](https://trackyourtime.dev/developers/): Keyboard clients, scoped integrations and own-server setup.
- [CSV migration guide](https://trackyourtime.dev/import-csv/): Columns, date order, preview, totals and import undo.
- [Phone tracking without signal](https://trackyourtime.dev/guides/offline-phone/): Prepare online, track offline and check queued entries after reconnect.
- [Moving between servers](https://trackyourtime.dev/guides/move-server/): Back up, copy a workspace and verify the destination.
- [Changelog](https://trackyourtime.dev/changelog/): Version notes generated from the source repository.
- [Home](https://trackyourtime.dev/): Free, open-source time tracking on every device, offline included. Reports, invoices, teams, import, export and an API, on the hosted service or on your own server with the same app.
- [Chrome extension](https://trackyourtime.dev/extension/): Start and stop the timer from the Chrome toolbar, add time you forgot, get entry suggestions from browsing activity, and keep tracking when the connection drops.
- [Raycast extension](https://trackyourtime.dev/raycast/): Start and stop the timer with a hotkey, and see it running in the Mac menu bar.
- [iPhone and Android](https://trackyourtime.dev/mobile/): Track billable time on an iPhone or Android phone without signal, against the hosted service or your own server. Changes sync when the connection returns.
- [Desktop app](https://trackyourtime.dev/download/): The desktop app for macOS, Windows and Linux: the timer in the menu bar or system tray, a shortcut that works in any app, and tracking that continues offline.
## Optional
- [API reference](https://trackyourtime.dev/docs/api/reference.md): Every REST endpoint under /api/v1, the scope it requires, and where its parameters go.
- [Webhooks](https://trackyourtime.dev/docs/api/webhooks.md): Webhook event catalogue, the signed request format, a Node verification example, retry and auto-disable behaviour, and the SSRF policy.
- [Rate limits](https://trackyourtime.dev/docs/api/rate-limits.md): The per-token and per-workspace request budgets, the RateLimit headers on every response, and how the limit behaves without Redis.
- [README](https://raw.githubusercontent.com/trebeljahr/trackyourtime/main/README.md): The full feature list, the repository layout and the development setup.
- [llms-full.txt](https://trackyourtime.dev/llms-full.txt): This file plus the full text of the self-hosting guide, the MCP page and the main API pages.
- [Privacy](https://trackyourtime.dev/privacy/): What the hosted service stores, why, who else sees it, and how to get it back or have it deleted.
- [Support](https://trackyourtime.dev/support/): How to get help, and answers to common questions.