# Standard Desktop App
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
import { Step, Steps } from 'fumadocs-ui/components/steps';
import { Callout } from 'fumadocs-ui/components/callout';
We also offer an **Experimental Timesheet AI App** with cutting-edge AI capabilities. It's perfect for early adopters who want to try new features before they're released. [Jump to experimental downloads](/new-desktop-app)
For a complete guide on getting started, see [Desktop app basics](https://help.timecamp.com/help/desktop-app-basics) article.
## Downloads
### Windows 10 & 11
**Download the installer (.exe)** [Download TimeCamp for Windows](https://download.timecamp.com/desktop/latest/windows)
**Run the installer** Locate the downloaded file and run it. Follow the on-screen instructions to complete the installation.
We also offer MSI installer for Windows. Please [contact us](https://www.timecamp.com/contact) if you need it.
### macOS
For macOS Monterey (version 12) and later (Intel and Apple Silicon).
**Download the disk image** [Download TimeCamp.dmg](https://download.timecamp.com/desktop/latest/macos)
**Install the application** Open the downloaded `.dmg` file and drag the TimeCamp icon to your Applications folder.
### Linux
**Ubuntu 22 & 24 with GNOME (Wayland)**
**Install Window Calls Extended GNOME extension**
To enable time tracking for applications on Ubuntu (>=21.04) or Debian, you need this extension.
**Option A: Using Extension Manager (recommended)**
1. Open Terminal.
2. Install Extension Manager:
```bash
sudo apt install -y gnome-shell-extension-manager
```
*(This may require administrator privileges)*
3. Open "Extension Manager" app.
4. Browse for `hseliger`.
5. Install **"Window Calls Extended"**.
**Option B: Using browser**
If you have the [GNOME Shell Integration](https://chromewebstore.google.com/detail/gnome-shell-integration/gphhapmejobijbbhgpjhcjognlahblep) browser extension installed, you can install "Window Calls Extended" directly from the [GNOME Extensions website](https://extensions.gnome.org/extension/4974/window-calls-extended/).
Once installed, the app should automatically start collecting information about open programs.
**Install TimeCamp application**
[Download for Ubuntu 22 & 24 (.deb)](https://download.timecamp.com/desktop/latest/ubuntu)
Install the `.deb` file using your preferred method (e.g., `sudo dpkg -i filename.deb` or double-clicking).
**Note:** TimeCamp doesn't start automatically after installation. Launch it manually from your application menu and provide your login details.
**Fedora 42+ with KDE (Wayland)**
Close existing TimeCamp app if it's running before proceeding.
**Download RPM installer**
[Download TimeCamp RPM](https://timecamp-public-desktop-app.s3.us-east-1.amazonaws.com/timecamp-desktop/prod-9eba558e/2025-10-27-13_01-master-1.8.4.0/timecamp-1.8.4.0-1.fc42.x86_64-fedora42.rpm)
**Open Terminal**
Launch your terminal application.
**Navigate to download location**
```bash
cd ~/Downloads
```
**Run installer**
Replace `timecamp.rpm` with the actual filename if different.
```bash
sudo dnf -y install ./timecamp.rpm
```
If it's already installed, you can use:
```bash
sudo dnf reinstall ./timecamp.rpm
```
**Start TimeCamp**
Find and start the TimeCamp app from your application launcher.
**Debian 12+**
TBD (similar to Ubuntu)
**SUSE**
Please [contact us](https://www.timecamp.com/contact)
**Missing distro?**
Please [contact us](https://www.timecamp.com/contact)
## What's New
### 12 Jul 2026 - v1.12.1
* **new**: Configurable screenshot capture frequency, including support for screenshots when no task is selected
* **new**: Task descriptions are now displayed in tooltips
* **new**: (Windows) Task tags can be requested before task selection when supported by the account
* **new**: (Windows) MSI installations now create a desktop shortcut
* **new**: Expanded enterprise deployment controls for authentication, autostart, proxy visibility, anonymous users, remote sessions and installer behavior
* **improvement**: Power, display-sleep, screen-lock, RDP and suspend handling now preserves tracking and away-time boundaries more accurately across Windows, macOS and Linux
* **improvement**: Away-time prompts now appear immediately after tracking stops, with more reliable idle-grace handling during activity uploads
* **improvement**: (Windows) Per-monitor DPI awareness improves widget scaling and rendering when moving between displays
* **improvement**: (Linux and macOS) Single-instance handling now allows one running app instance per operating-system user
* **improvement**: Deep-link registration is now handled by installers for more reliable login and launch behavior
* **improvement**: Task hierarchy paths now use forward slashes consistently across platforms
* **improvement**: Updated wxWidgets to 3.3.2 and libcurl to 8.19.0 for compatibility, stability and security
* **improvement**: Database access now uses prepared statements and safer multi-threaded connection handling
* **improvement**: (Linux) Activity tracking falls back to generic computer activity when detailed application data is unavailable
* **fix**: Expired API sessions returning HTTP 401 are now handled consistently and prompt reauthentication
* **fix**: (Windows and Linux) Missing application and installer icons were restored
* **fix**: (Windows) Installers now close running application processes more reliably during upgrades
* **fix**: Fixed application shutdown crashes and taskbar icon cleanup issues
* **fix**: Active activity is flushed before upload, preventing recent tracking data from being omitted
* **fix**: Working-time limits no longer suppress the application-started activity
* **fix**: Tracking continues through computer or display sleep when pausing on session lock is disabled
* **fix**: Widget labels, bitmap paths, pause-button visibility and high-DPI resizing now render correctly
* **fix**: (macOS) Clicking the menu-bar icon opens the menu instead of the task picker
* **fix**: (Windows) The first tray-menu item no longer appears bold
* **fix**: (Ubuntu) Closing and reopening a laptop lid now records breaks correctly
### 10 Mar 2026 - v1.9.4
* **fix**: (Windows)Enabled missing SSL certificate revocation checks for improved connection security
### 3 Mar 2026 - v1.9.3
* **new**: (Linux) Deep link (`tc://`) schema support for Linux
* **improvement**: (Windows) Improved NSIS installer process termination to prevent conflicts during upgrades
* **improvement**: Menu item label translations fixed across platforms
* **improvement**: Path resolution normalized for application resources on macOS, Windows and Linux
* **improvement**: (Linux) Linux computer activity fallback — logs generic "computer activity" when specific data unavailable
* **fix**: (Linux) Application indicator icon corrected on Linux
* **fix**: (Linux) UTF-8 strings passed correctly to GTK notifications and library on Linux
* **fix**: (Linux) Language directory resolution fixed for proper translations loading
* **fix**: (Windows)Unused DLLs removed to reduce application size
### 24 Feb 2026 - v1.9.2
* **improvement**: Updated libcurl to 8.18.0 for better performance and security
* **improvement**: Unified installer configuration using config.json
* **improvement**: Installer build process streamlined with universal WXS configuration
### 17 Feb 2026 - v1.9.1
* **new**: Option to disable file logging via configuration
* **new**: Custom app naming support for white-label deployments
* **improvement**: SSL verification enabled for all HTTP POST calls
* **improvement**: Installer build process modernized with Python-based tooling and Azure Trusted Signing
* **fix**: macOS resource path resolution corrected
### 11 Feb 2026 - v1.9.0
* **fix**: Text in the windget was trimmed on high-dpi screens
* **fix**: Long email addresses now display correctly in the user interface
* **fix**: Server response logging improved in file uploader
* **fix**: Task time span requests no longer run concurrently, preventing duplicate API calls
### 9 Feb 2026 - v1.8.8
* **new**: Brave browser support for automatic activity tracking
* **improvement**: Unified away-time dialog across all platforms (macOS, Windows, Linux)
* **improvement**: Away-time dialog layout and button visibility improvements
* **fix**: Task time span requests no longer run concurrently, preventing duplicate API calls
* **fix**: Polish translations updated
### 24 Jan 2026 - v1.8.7
* **new**: API token manual login for environments where deep link login is unavailable
* **new**: Option to retain uploaded screenshots instead of deleting after upload
* **new**: Blurred screenshot mode for enhanced privacy before uploading
* **new**: Automatic tracking mode support via server configuration
* **new**: Server-side control for window title collection
* **improvement**: Language resources included in Linux RPM and DEB packages
* **improvement**: DPI override for better display scaling on Windows
* **improvement**: Enhanced XML data preparation for REST API calls
* **improvement**: Server-configurable idle time override for auto-updates
* **fix**: Linux package dependencies updated
* **fix**: First run window display fixed on certain configurations
### 5 Jan 2026 - v1.8.6
* **improvement**: Enhanced idle time detection for Wayland sessions on Linux
* **fix**: macOS taskbar icon now retains correct color when inactive
* **fix**: Screenshots retained on server errors (last 10 kept for debugging)
* **fix**: Thread management in fraud detectors fixed to prevent macOS crashes
# Getting started
Explore our documentation to learn about:
* **[Getting Started](/new-desktop-app)** - Installation, setup, and first steps
* **[Views](/new-desktop-app/views)** - Calendar, Table, List, Timeline, and more
* **[AI Features](/new-desktop-app/ai-features)** - Smart categorization and descriptions
* **[Power Features](/new-desktop-app/power-features)** - Advanced tracking capabilities
* **[Plugins](/new-desktop-app/plugins)** - Extend functionality with plugins
* **[What's New](/new-desktop-app/whats-new)** - Latest updates and improvements
* **[Roadmap](/new-desktop-app/roadmap)** - Upcoming features and plans
# MCP Server
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
import { Callout } from 'fumadocs-ui/components/callout';
The TimeCamp MCP (Model Context Protocol) server allows AI assistants to interact with your TimeCamp data directly. You can start, stop, and manage time entries, browse projects and tasks, and more — all through natural language conversations with your favorite AI tool.
MCP is an open standard that enables AI models to securely connect to external data sources and tools. Learn more at [modelcontextprotocol.io](https://modelcontextprotocol.io).
## Server URL
```
https://mcp.timecamp.com/mcp
```
## What you can do
With the TimeCamp MCP server, your AI assistant can:
* Start and stop time tracking
* Create and manage time entries
* Browse projects and tasks
* View tracked time summaries
* Manage your TimeCamp workspace
## Setup
### Claude Desktop
1. Open Claude Desktop and go to **Settings** → **Connectors** → **Customize**
2. Click the **+** icon → **Add custom connector**
3. Enter the following URL:
```
https://mcp.timecamp.com/mcp
```
4. Click **Save**
5. Claude will prompt you to authenticate with your TimeCamp account
### Claude Code (CLI)
Add the server using the CLI:
```bash
claude mcp add timecamp https://mcp.timecamp.com/mcp
```
### ChatGPT
1. Open [chatgpt.com](https://chatgpt.com) and go to **Settings** → **Connected apps**
2. Click **Add connection**
3. Search for "TimeCamp" or enter the server URL manually:
```
https://mcp.timecamp.com/mcp
```
4. Click **Connect** and authenticate with your TimeCamp account
5. TimeCamp tools will now be available in your ChatGPT conversations
### Cursor IDE
Add the TimeCamp MCP server to your Cursor configuration:
1. Open **Cursor Settings** → **MCP**
2. Click **Add new MCP server**
3. Choose **Type: URL** and enter:
```
https://mcp.timecamp.com/mcp
```
Alternatively, add it directly to your `.cursor/mcp.json` file:
```json
{
"mcpServers": {
"timecamp": {
"url": "https://mcp.timecamp.com/mcp"
}
}
}
```
4. Restart Cursor or reload the MCP servers
5. You'll be prompted to authenticate with your TimeCamp account
### Any MCP-compatible client
**Server URL:**
```
https://mcp.timecamp.com/mcp
```
#### Configuration examples
**JSON configuration** (commonly used by MCP clients):
```json
{
"mcpServers": {
"timecamp": {
"url": "https://mcp.timecamp.com/mcp"
}
}
}
```
**Windsurf:**
Add to your Windsurf MCP settings with the URL `https://mcp.timecamp.com/mcp`.
**VS Code (Copilot):**
Add to your `.vscode/mcp.json`:
```json
{
"servers": {
"timecamp": {
"url": "https://mcp.timecamp.com/mcp"
}
}
}
```
Authentication is handled via OAuth. When you first connect, your AI client will redirect you to TimeCamp to authorize access.
# Power BI
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
import { Callout } from 'fumadocs-ui/components/callout';
TimeCamp offers three ways to be connected with Power BI:
1. Using free REST API in Power BI Desktop
2. Export data to any database using an open-source script, then connect Power BI to it
3. For self-hosted TimeCamp, connect to the database directly
We offer free consultation, please choose the best time, by clicking [this link](https://meetings-eu1.hubspot.com/kamil-rudnicki).
This method connects Power BI Desktop directly to the TimeCamp REST API. It's free and easy to set up.
#### Step 1: Download the example report
Download our pre-configured Power BI report template:
**[Download TimeCamp Power BI Report](/docs/powerbi/Time%20entries%20PowerBI%20\(test%20user%20token\).pbix.zip)**
#### Step 2: Open the report in Power BI Desktop
1. Open **Power BI Desktop** (free download from Microsoft)
2. Open the downloaded `.pbix` file
#### Step 3: Replace the API token with your own
1. In Power BI Desktop, go to **Home** → **Transform data** → **Edit parameters**
2. Paste your TimeCamp API token into the "ApiToken" parameter
3. Click **OK**, then **Apply changes**
**Where to find your TimeCamp API token:**
* Log in to TimeCamp
* Go to **Settings** → **Your Profile**
* Copy your API token from the profile page
[Instruction](https://docs.google.com/document/d/16r547_ZdbYhA0oj2w8iZht8I0FsRg6MZ1Cpo0iEltAw/edit?tab=t.0)
#### Step 4: Refresh the data
Click **Refresh** to load your TimeCamp data into the report.
This method only works with **Power BI Desktop**. For Power BI Online, use the "Export to database" method instead.
### Export data to a database, then connect Power BI
This method gives you the most flexibility and works with both **Power BI Desktop** and **Power BI Online**. We recommend using Google BigQuery as your data warehouse.
#### Step 1: Export TimeCamp data to a database
Use our open-source data pipeline to export your TimeCamp data:
1. Visit the [TimeCamp Data Pipeline](https://github.com/timecamp-org/good-enough-timecamp-data-pipeline) repository on GitHub
2. Follow the setup instructions in the README
3. Run the pipeline to export your data to your preferred destination:
* **Google BigQuery** (recommended)
* PostgreSQL
* MySQL
* DuckDB
* CSV/Parquet files
**Available datasets you can export:**
* Time entries with project/task details
* Projects & tasks hierarchy
* Computer activities (desktop app tracking)
* Users with group information
* Application names and categories
#### Step 2: Connect Power BI to your database
Once your data is in the database, connect Power BI to it:
**For Google BigQuery:**
1. Open **Power BI Desktop** or go to **Power BI Online**
2. Click **Get Data** → **Database** → **Google BigQuery**
3. Sign in with your Google account that has access to BigQuery
4. Select your BigQuery project and dataset
5. Choose the tables you want to import (entries, tasks, users, etc.)
6. Click **Load** to import the data
**For other databases:**
Use the appropriate connector in Power BI (PostgreSQL, MySQL, etc.) and enter your database credentials.
#### Benefits of this approach
* Works with Power BI Online (cloud) and Desktop
* Automatic data refresh scheduling
* Better performance for large datasets
* Full control over your data
Please contact us at [sales@timecamp.com](mailto:sales@timecamp.com) if you are interested in self-hosted version of TimeCamp.
# Download TimeCamp
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
import { Step, Steps } from 'fumadocs-ui/components/steps';
Download the **Standard TimeCamp Desktop App** — our recommended time tracking solution that works reliably across all major platforms.
We also offer an **Experimental Timesheet AI App** with cutting-edge AI capabilities. It's perfect for early adopters who want to try new features before they're released. [Jump to experimental downloads](#experimental-timecamp-timesheet-app)
### Windows 10 & 11
### Download & Install
1. Download the installer from the link above
2. Run the `.exe` file and follow the installation wizard
3. Launch TimeCamp from your Start menu
### Grant Permissions
When prompted, allow TimeCamp to run at startup for automatic time tracking.
### macOS Monterey (12) and later
### Download & Install
1. Download the `.dmg` file from the link above
2. Open the downloaded file
3. Drag TimeCamp to your Applications folder
4. Launch TimeCamp from Applications
### Grant Permissions
When prompted, grant the following permissions in **System Settings → Privacy & Security**:
* **Accessibility** — required for tracking apps/windows
* **Screen Recording** — optional, enables OCR features
Choose your Linux distribution below.
### Fedora 42+ with KDE (Wayland)
Close any existing TimeCamp app if it's currently running.
### Download the RPM
Download the RPM installer from the link above.
### Install via Terminal
Open Terminal and navigate to your Downloads folder:
```bash
cd ~/Downloads
```
Install the package (adjust the filename if needed):
```bash
sudo dnf -y install ./timecamp-1.8.4.0-1.fc42.x86_64-fedora42.rpm
```
If TimeCamp is already installed and you want to reinstall, use `sudo dnf reinstall` instead.
### Launch TimeCamp
Find and start the TimeCamp app from your application menu.
***
### Ubuntu 22 & 24 with GNOME (Wayland)
🐧
Download for Ubuntu
DEB Package • Version 1.8.6.3
📦 [**Download DEB Installer**](https://timecamp-public-desktop-app.s3.us-east-1.amazonaws.com/timecamp-desktop/dev-e8f29240/2025-12-21-09_18-linux_idle_time_fix-1.8.6.3/timecamp_1.8.6.3-dev_amd64-ubuntu2204.deb)
### Install GNOME Extension (Required)
To enable time tracking on Ubuntu 21.04+ or Debian with GNOME, you need to install an extension that allows TimeCamp to gather window information.
1. Open the **Terminal** app
2. Install the Extension Manager:
```bash
sudo apt install -y gnome-shell-extension-manager
```
3. Open the **Extension Manager** app
4. Go to the **Browse** tab and search for `hseliger`
5. Click **Install** next to **"Window Calls Extended"**
Once installed, the app will automatically start collecting information about open programs.
### Install TimeCamp
Download the `.deb` package from the link above and install it using your preferred method:
**Option A — Using Software Center:**
Double-click the downloaded `.deb` file
**Option B — Using Terminal:**
```bash
cd ~/Downloads
sudo dpkg -i timecamp_1.8.6.3-dev_amd64-ubuntu2204.deb
```
### Launch TimeCamp
Find and start the TimeCamp app from your application menu.
***
### Debian 12+
Installation is similar to Ubuntu. Detailed instructions coming soon.
***
### SUSE / Other Distributions
# AI features
import { Accordion, Accordions } from 'fumadocs-ui/components/accordion';
**The first fully automated time tracker.**
Fifteen years ago, we pioneered automatic time tracking with keywords. Now, the next chapter.
TimeCamp watches how you work, learns your patterns, and fills your timesheet—without you lifting a finger.
No timers. No manual entry. Just accurate time data.
Privacy first. Data stays local and private.
## What AI Can Do
* ✅ **Suggest tasks** based on your activities
* ✅ **Generate descriptions** from screen content
* ✅ **Auto-fill gaps** in your timesheet
* ✅ **Learn from corrections** to improve over time
* ✅ **Chat** you can use Assistant as general purpose chat with tools, scheduled tasks
## Pro Tips
1. **Keep app running** - Add to login items for auto-start
2. **Review suggestions** - Correct mistakes to improve AI
3. **Organize projects** - Clear structure in TimeCamp = better AI
4. **Task descriptions** - Describe your tasks in a way that is easy for AI to understand in Description field in [TimeCamp](https://app.timecamp.com/app#/active-projects)
## Available Models
You can pick the model in **Settings → AI**. Relative cost is shown against `google/gemini-pro-latest`.
Our recommended model (price/performance ratio) is set as `auto` in Settings. It may change over time, but it's usually the best model for most use cases.
| Model | Modality | Relative cost | Comment |
| -------------------------------- | ---------- | ------------- | ----------------------------------------------------- |
| `openai/gpt-latest` | Multimodal | \~2.5× | |
| `anthropic/claude-sonnet-latest` | Multimodal | \~1.4× | |
| `google/gemini-pro-latest` | Multimodal | 1× (baseline) | |
| `deepseek/deepseek-pro-latest` | Text only | \~0.65× | From time to time, fails more often than other models |
| `google/gemini-flash-latest` | Multimodal | \~0.25× | |
| `google/gemma-latest` | Multimodal | \~0.05× | From time to time, fails more often than other models |
Models are not deterministic, so you may get different results with the same input and same model.
Sometimes models that cost more, can perform worse than cheaper models. It's best to test this by yourself. Open specific time entry and click `Suggest with AI` button, then change model in Settings and see if the results are better.
We offer help to determine the best model for your use case using evals. [Contact us](https://www.timecamp.com/contact) for more information.
## Keep Using AI Features
Every workspace starts with **$10 in free AI credits**—enough to see the magic for yourself. Once you've used them up, pick how you'd like to keep going:
1. **Top up through TimeCamp** — Plans start at **$4.99/month**. Add credits for yourself or your whole team in one place. No setup, no hidden fees, cancel anytime [https://billing.timecamp.com](https://billing.timecamp.com).
Get credits now
2. **Bring your own API key** — Prefer to manage AI yourself? Connect any model via [OpenRouter](https://openrouter.ai/) in **Settings → AI** and pay your provider directly.
## FAQ
* **macOS** (10.15 or higher - only ARM64 architecture is supported currently)
* **Windows** (10 or higher)
Linux is not supported yet, we plan to support it in the future.
App tracks the following data and saves it in local SQLite database:
* Application name
* Window title
* URL of the browser tab
* OCR of the opened window (optional, processed locally, by default disabled)
It can be set in app Settings. You can switch to any of the [available models](#available-models) in **Settings → AI**. All models run with a strict no-data policy:
* No training on your data
* No data retention
* Full control with private Azure or custom API keys using OpenRouter API
The application will ask for two permissions on MacOS:
1. **Accessibility Permission**
* Allows the app to track which applications and windows are active
* Required for computer activity monitoring
* Grant in: System Settings → Privacy & Security → Accessibility
2. **Screen Recording Permission (optional)**
* Required for OCR (screen text capture) functionality
* Allows the app to capture screen content for analysis
* Grant in: System Settings → Privacy & Security → Screen Recording
**Note**: The app will automatically prompt you to grant these permissions on first launch. You must grant both for full functionality.
## Legal
For the legal terms that apply to TimeCamp products, please refer to TimeCamp's [Privacy Policy](https://www.timecamp.com/privacy-policy/#:~:text=AI%20TIME%20TRACKER%20PRIVACY%20POLICY), [Terms & Conditions](https://www.timecamp.com/terms-conditions/#:~:text=11.-,AI%20Terms%20of%20Service,-1.%20AI%20suggestions), and [List of Sub-Processors](https://www.timecamp.com/subprocessors/#:~:text=Third%2DParty%20AI-,Subprocessors,-%28Only%20if%20AI).
### Privacy Policy
See TimeCamp's [Privacy Policy](https://www.timecamp.com/privacy-policy/#:~:text=AI%20TIME%20TRACKER%20PRIVACY%20POLICY).
### Terms of Service
See TimeCamp's [Terms & Conditions](https://www.timecamp.com/terms-conditions/#:~:text=11.-,AI%20Terms%20of%20Service,-1.%20AI%20suggestions).
### Subprocessors
See TimeCamp's [List of Sub-Processors](https://www.timecamp.com/subprocessors/#:~:text=Third%2DParty%20AI-,Subprocessors,-%28Only%20if%20AI).
# FAQ
## How to fix an API token problem
If the app cannot sync data, asks you to log in again, or reports an API token problem, replace the token saved in the desktop app.
1. Open TimeCamp [Profile Settings](https://app.timecamp.com/app#/settings/users/me) and copy your current API token.
2. Open the menubar app and click `Settings...`.
3. Click the `Configure` in Account integrations section.
4. Remove the token (make it empty)
5. Click `Back to settings` and close the settings window.
6. Open main window, you should see Onboarding dialog, where you can enter the new API token.
## How to change or disable global keyboard shortcut
You can change or turn off the global shortcut in the app settings:
1. Open the menubar app and click `Settings...`
2. Click the `⚙️` icon for `Timesheet` or `Assistant`
3. Scroll to `Keyboard Shortcuts`
4. Set a new shortcut or disable the global shortcut
## How to change time entries granularity
You can change or turn off the global shortcut in the app settings:
1. Open the menubar app and click `Settings...`
2. Click the `⚙️` icon for `Timesheet`
3. Change value for `AI proposal snap interval` to a new value (default is 30 minutes)
## How to disable or enable memory blocks
You can change or turn off the global shortcut in the app settings:
1. Open the menubar app and click `Settings...`
2. Click the `⚙️` icon for `Timesheet`
3. Change value for `Memory blocks`
# Getting started
import { Step, Steps } from 'fumadocs-ui/components/steps';
import { Callout } from 'fumadocs-ui/components/callout';
{/*
Desktop App That Tracks Time While You Work
*/}
The world's #1 time tracking agent app.
Desktop app uses AI to passively track time.
Beautiful, instant, and private timesheeting on your own device.
[See all views →](/new-desktop-app/views)
### Install & Launch
1. Download and install **TimeCamp Desktop Time Tracker**
2. Launch the application
3. On MacOS, grant **two permissions** when prompted:
* **Accessibility** (tracks apps/windows)
* **Screen Recording** (for OCR features - optional)
### Connect TimeCamp
1. Get API token from TimeCamp → [Profile Settings](https://app.timecamp.com/app#/settings/users/me) → API Token
2. Enter token in TimeCamp Timesheet plugin
3. Done! Your entries will sync automatically
### Start Tracking
* The app tracks automatically in the background
* Use Calendar, Table, Text, List views to see your tracked time
## Main Features
### Automatic Tracking
* Tracks all applications you use
* Monitors active time
* Works in background automatically
### TimeCamp Integration
* Sync entries to TimeCamp
* Pull tasks/projects
* Real-time updates
### Smart Features
* Overlap/gap detection
* Compact mode (tiny window)
* Keyboard-first workflow
## How to Update
### Open Settings
Click **Settings** from the menu bar.
### Click Update
In the Settings window, click the **Update** button.
If you don't see the new version banner, **restart the application**.
### Wait for the Update
The app will download and install the update automatically.
## How to Find Logs
If you need to share logs for troubleshooting:
1. Open menubar menu and go to **Settings**.
2. Scroll down and click **Open App Logs...**.
3. Open selected file or send it to us at [support@timecamp.com](mailto:support@timecamp.com).
## How to update TimeCamp API Token
1. Left click on menubar icon and open **Settings**. On Windows click arrow near clock, then find Desktop Time Tracker icon, then click **Settings**.
2. Click on **Calendar** gear icon.
3. Paste new API token and click **Back to settings**.
## Troubleshooting
| Problem | Solution |
| ------------------ | ----------------------------------------- |
| **Not tracking** | Check both permissions in System Settings |
| **AI not working** | Check daily limit; wait until tomorrow |
| **Sync issues** | Verify API token; check internet |
| **High CPU usage** | Disable OCR if not needed |
# Plugins
The plugin system is not yet publicly available. Contact us for early access to start building plugins.
## 🎯 Overview
**The plugin system transforms Desktop Time Tracker from a standalone tool into an extensible platform, empowering users to adapt the application to their unique workflows.**
Desktop Time Tracker is built with extensibility at its core, following a plugin architecture similar to **VS Code** and **Obsidian**. Just as VS Code transforms from a text editor into a full IDE through extensions, and Obsidian evolves from a note-taking app into a knowledge management system through community plugins, Desktop Time Tracker provides a robust plugin system that allows developers to extend functionality, customize behavior, and integrate with external services without modifying the core codebase.
## 🏗️ Architecture Principles
### Similar to VS Code & Obsidian
Like these popular extensible applications, Desktop Time Tracker's plugin system provides:
* **Isolated Execution**: Each plugin runs independently with controlled access to core APIs (similar to VS Code extensions)
* **Rich API Surface**: Comprehensive APIs for UI, data access, and system integration (like Obsidian's plugin API)
* **TypeScript-First Development**: Full type safety and IntelliSense support throughout development
* **Hot Reload**: Rapid development with automatic reload on code changes
* **Community Extensibility**: Users can install third-party plugins or build their own
### Plugin Capabilities
The plugin architecture follows a **sandbox model** where each plugin runs in isolation with a well-defined API. Plugins can:
* Access user activity data through secure queries
* Create custom windows and UI components
* Integrate with AI providers for intelligent features
* Store data in dedicated SQLite databases
* Communicate with external services
* Add custom tray menu items and keyboard shortcuts
### Core Components
**Plugin API** - A TypeScript-first interface providing access to:
* Activity tracking data
* AI prompt execution with cost tracking
* Window management and UI rendering
* Database operations (per-plugin SQLite instances)
* System notifications and clipboard access
* Configuration management with validation
**Plugin Manifest** - Each plugin declares metadata including version requirements, permissions, and capabilities through a `manifest.json` file.
**Hot Reload Development** - Plugins can be developed with live reload capability, connecting remotely to the running application for rapid iteration.
## ✨ Plugin Capabilities
* **Data Access** - Query activity records with time filters, and active/passive tracking via TypeScript-typed APIs
* **UI Flexibility** - Create standalone windows, main window views, or frameless overlays with full customization
* **AI Integration** - Execute prompts through configured providers with automatic cost tracking, caching, and reasoning support
* **Configuration** - Define validated user settings with support for string, number, boolean, enum, and action field types
## 💡 Inspiration for Plugins
* **Project Management Integration**: Connect with Jira, Asana, or Linear to auto-log time entries
* **Reporting & Analytics**: Generate weekly summaries, productivity charts, or export to custom formats
* **Focus Tools**: Detect distracting websites/apps and provide gentle nudges
* **Team Collaboration**: Share anonymized productivity patterns with team dashboards
* **Health Reminders**: Periodic break notifications based on continuous work detection
# Power features
import { Callout } from 'fumadocs-ui/components/callout';
**Pro tip**: Master keyboard shortcuts first—they provide the immediate productivity boost.
### Keyboard Shortcuts
* ⌘E / CtrlE - Start new timer (global shortcut)
* E - Edit hovered entry
* R - Remove hovered entry or delete in edit dialog
* N - Start a new empty timer
* S - Stop the current timer
* T - Add new entry for Today (hover Today's header or anywhere in window)
* Enter - Save changes
* ShiftEnter - Add new line in notes field
### Workflow Enhancements
* Change to more powerful AI models by adding your own OpenRouter API key in Settings.
* In Text view, you can save your propmpts to memory, so they will be applied automatically next time.
* Improve AI suggestions by providing your own examples and prompts in Settings. Make it yours, make it personal. Iterate.
```
I mostly work on projects XYZ, ABC, and DEF. Try to match those.
Time entries descriptions should sound professional and concise. Should be in Spanish.
Don't add activities to descriptions, only general task descriptions.
Example of good description: "Reviewed and updated project XYZ documentation".
```
### Data
* Access your raw data by openning Settings and clicking on "Open Database".
* Use SQLite database for custom analysis in Jupyter notebooks, DuckDB, or BI tools.
* Make regular backups - it's just a SQLite database files.
Read how TimeCamp CEO tracked his time with raw data in [this article](https://kamilrudnicki.com/archive/www/i-tracked-every-hour-in-2024-as-time-camp-ceo-and-here-are-the-results/) for inspiration.
# Roadmap
We're continuously working to improve the TimeCamp Desktop App. Here's what's on our roadmap:
### AI & Intelligence
* [ ] **Local LLM models** - Run AI features entirely on your device for enhanced privacy and offline capability
* [ ] **Better recognition of tasks by AI** - More accurate automatic task detection and categorization
* [ ] **Local-only dictionaries** - Custom project, task, and activity type dictionaries stored exclusively on your device
### Integrations
* [ ] **Calendar integration** - Seamlessly sync and track time from your calendar events
* [ ] **Calls log integration** - Automatically log time spent on calls and meetings
* [ ] **TimeCamp platform integration** - Full sync with TimeCamp web and mobile apps
### Productivity Features
* [ ] **Autotracker** - Intelligent automatic time tracking based on your activity patterns
* [ ] **Idle detection** - Automatically detect and handle idle time
* [ ] **Plugins marketplace** - Extend functionality with community-built plugins and integrations ([Learn more](/new-desktop-app/plugins))
### User Experience
* [ ] **Total time in macOS menu bar** - Quick glance at your tracked time directly from the menu bar
# Tutorial
Choose the method that fits your workflow best. Whether you prefer real-time tracking, end-of-day reviews, or complete automation, TimeCamp has you covered.
## TIMESHEETS
| Method | Best For | Accuracy | Effort | Recommended Feature |
| :-------------- | :------------------------ | :------- | :----- | :----------------------------------------------------- |
| **Real-time** | Billing, multitasking | ⭐⭐⭐⭐⭐ | High | [Quick Start](/new-desktop-app/views#quick-start-task) |
| **End of Day** | Deep work, memory aid | ⭐⭐⭐⭐ | Medium | [Calendar](/new-desktop-app/views#calendar) |
| **End of Week** | Long tasks, few projects | ⭐⭐⭐ | Low | [Calendar](/new-desktop-app/views#calendar) |
| **Automatic** | Everyone, forgetful users | ⭐⭐⭐⭐⭐ | None | [AI Features](/new-desktop-app/ai-features) |
### Tracking time in real time using timers
Stay focused on the task at hand by starting timers as you work. This is the most accurate way to capture every minute as it happens, perfect for billing clients or detailed project tracking.
1. Use the [Quick Start](/new-desktop-app/views#quick-start-task) launcher (Cmd+E / Ctrl+E)
2. Or start a timer from the [Widget](/new-desktop-app/views#widget) or Menubar
### Tracking time at the end of the day
Prefer to work uninterrupted? Fill in your timesheet once your day is done. Use the visual memory aids to recall exactly what you worked on.
* Use [Calendar View](/new-desktop-app/views#calendar) to block out your day
* Use [List View](/new-desktop-app/views#list) for a quick checklist approach
### Tracking time at the end of the week
If your week consists of fewer, longer tasks, a weekly review might be all you need. Quickly fill in gaps and ensure everything is accounted for before the weekend.
*Best if you don't have many distinct tasks.*
* Use [Table View](/new-desktop-app/views#table) for bulk editing and review
### Tracking time completely automatically
Forget about timers altogether. Let AI do the heavy lifting by observing your work patterns and filling your timesheet for you.
* Learn more about [AI Features](/new-desktop-app/ai-features)
* Configure [Power Features](/new-desktop-app/power-features) for better accuracy
## DAILY SUMMARY
### Sharing what you did in a day with a team
Need to send a stand-up update or a daily report? Quickly generate a text summary of your day to share with your team via Slack, Email, or standard stand-up meetings.
* Use [Text View](/new-desktop-app/views#text) to copy-paste your day's summary
* Use chat to customize tone of the summary
# Views
Choose the perfect view for how you work. TimeCamp offers multiple ways to visualize and interact with your time tracking data.
### Calendar
See your time unfold across days, weeks, and months in a beautifully intuitive calendar view. Effortlessly spot patterns, identify your most productive periods, and understand how your time flows throughout each month—all at a glance.
1. Click `Open...` in the menubar icon to open
2. Optionally click on app icon
### List
Your activities flow in a clean, chronological list that makes every moment easy to scan and understand. Edit entries instantly, review your day's work effortlessly, and stay organized without ever feeling overwhelmed.
### Table
Powerful data organization meets elegant simplicity in a structured table that lets you sort, filter, and analyze your time with precision. Transform raw tracking data into meaningful insights with just a few clicks.
### Text
Sometimes the simplest view is the most powerful. Plain text gives you complete control, letting you edit entries naturally and work with your data exactly how you think—no interface getting in your way.
### Timeline
Watch your day unfold visually as activities flow seamlessly across a horizontal timeline. Instantly see where your time goes, spot gaps, and understand the rhythm of your workday in one beautiful, continuous view.
1. Click `Open Timeline...` in the menubar to open
2. Optionally click on timeline icon in `Calendar view`
### Widget
Your time tracking, always within reach. A compact, elegant widget sits quietly in your workspace, showing exactly what you need to know without demanding attention. It's there when you need it, invisible when you don't.
1. Right click on the app icon in the menu bar
2. Select `Show Widget`
### Quick Start Task
Start tracking instantly from anywhere with a spotlight-like launcher. Press Cmd+E (Mac) or Ctrl+E (Windows/Linux) to summon a powerful quick-start interface that lets you begin timing any task without breaking your flow.
1. Click Cmd/Ctrl+E to open
2. Select task and start tracking
3. Optionally before selecting a task write a note
Tip: You can also access `Quick Start` in `menubar`, `calendar view` and `timeline view`.
You can also change default shortcut in `Settings` by clicking on `Settings...` in the menubar and then gear icon `⚙️` for `Calendar` and then `Keyboard Shortcuts`.
### Screen Time
See exactly how much time you spend in each application and website. The Screen Time plugin gives you a clear breakdown of your digital habits, complete with favicons for easy recognition, helping you understand where your attention goes throughout the day.
# What's new
📦 [Download latest version for Windows](https://download.timecamp.com/desktop-app/windows) →\
📦 [Download latest version for MacOS](https://download.timecamp.com/desktop-app/macos) →
If you already have application running, you can update the app from [Settings](/new-desktop-app#how-to-update).
### 02 Aug 2026 - v1.11.16
**Scratchpad**
* **new**: Optional Scratchpad plugin for timestamped local notes that help AI suggest better tasks and descriptions, with a quick-add shortcut and Markdown backups
**TimeCamp Timesheet**
* **new**: Optional automatic approval of time entry suggestions from previous days, with separate modes for tasks only or tasks and notes
* **improvement**: Clearer warnings for missing or unauthorized TimeCamp accounts, plus an action to resume suggestions after inactivity
**Assistant (AI Agent)**
* **new**: Optional local MCP server lets external AI assistants access activity and TimeCamp data and manage tasks, entries, timers, and memory blocks
**General**
* **fix**: Removed the inactive Pomodoro plugin from the available plugins list
### 22 Jul 2026 - v1.11.15
**TimeCamp Timesheet**
* **new**: AI suggests better tasks for a running timer in Timesheet and the mini widget, explains each match, and lets you switch with one click
* **new**: Missing time entry suggestions are generated on startup and every five minutes
* **new**: Add a time entry directly from the table toolbar
* **improvement**: Favorite tasks are no longer limited by TimeCamp's server cap and remain available locally
* **improvement**: Refreshed running timer controls and mini widget interactions
**Assistant (AI Agent)**
* **improvement**: Smoother transitions for warnings and scheduled-job messages
* **fix**: Scheduled jobs with a missing next-run time now start automatically
### 14 Jul 2026 - v1.11.13
**TimeCamp Timesheet**
* **fix**: Users with admin or non-standard task permissions can see all active tasks available to them again
**Assistant (AI Agent)**
* **fix**: Conversation compaction no longer duplicates messages already covered by earlier summaries
### 12 Jul 2026 - v1.11.12
**TimeCamp Timesheet**
* **new**: A diagnostic warning now explains why AI time entry suggestions are unavailable and how to restore them
* **improvement**: Running timers and total durations now update with smoother number animations in Timesheet and Pomodoro
* **improvement**: Refreshed controls, tooltips, activity details, and memory block details across timesheet views
* **fix**: AI suggestions are generated and displayed more reliably, including when automatic generation is disabled
* **fix**: Opening an AI proposal now shows the correct proposal in the edit dialog
* **fix**: Archived tasks keep their names, and task breadcrumbs no longer repeat the task name
* **fix**: The onboarding sample calendar scrolls to the replay correctly, including later in the day
* **fix**: Removed duplicate Today controls and improved empty-state readability
* **fix**: Time entry errors now provide clearer, more useful messages
**Assistant (AI Agent)**
* **improvement**: Faster assistant and scheduled-job responses by disabling unnecessary model reasoning
* **improvement**: Refreshed controls and clearer keyboard shortcut tooltips
### 01 Jul 2026 - v1.11.11
**TimeCamp Timesheet**
* **fix**: Missing local timesheet tables are now restored automatically during database initialization
### 29 Jun 2026 - v1.11.9
**TimeCamp Timesheet**
* **new**: AI can suggest a new task and create it directly from the time entry edit dialog when no existing task fits
* **fix**: Editing and replacing time entries is more reliable
* **fix**: AI task suggestions are generated and attached to the correct time entry more consistently
**Assistant (AI Agent)**
* **fix**: Duplicate context rows no longer interrupt conversation summary compaction
### 28 Jun 2026 - v1.11.8
**Pomodoro**
* **new**: Optional Pomodoro plugin with task-based focus sessions, local session history, completion sound, and a completion window
* **new**: Completed or stopped Pomodoro sessions can be added to TimeCamp Timesheet as time entries
* **improvement**: Pomodoro history supports renaming, restarting, and deleting sessions
**TimeCamp Timesheet**
* **new**: Memories can now be shown as their own track in Timeline and toggled from the visible tracks menu
* **improvement**: Smoother loading and refresh behavior across calendar, list, table, week, and timeline views
* **improvement**: Click a day header in week view to sort tasks by the time logged on that day
* **improvement**: Memory blocks are now disabled by default so AI memory generation only runs after it is explicitly enabled
* **fix**: Editing a time entry now recalculates duration from start and end times, including timeline drag edits
* **fix**: AI suggestions no longer treat Calendar Events entries as real tracked work when looking for gaps
* **fix**: In-progress memory blocks are no longer shown in calendar view
**Assistant (AI Agent)**
* **new**: Settings can disable the assistant's system command, file read, and file edit tools
* **improvement**: HTML previews render more safely and stay responsive during long streamed responses
* **improvement**: Assistant stream updates are buffered to reduce chat slowdown during large responses
* **fix**: Memory block tool calls are more tolerant of common date-range argument mistakes
### 10 Jun 2026 - v1.11.7
**TimeCamp Timesheet**
* **new**: Animated sample calendar replay for new users after onboarding, showing activity, memories, entries, and AI suggestions as a tracked day
* **improvement**: Activity and memory side columns start expanded for first-time calendar users
* **fix**: Sample calendar data now appears only after onboarding is complete and is marked as shown after the first replay or dismissal
**Assistant (AI Agent)**
* **improvement**: Chat history now shows a local-only privacy notice
### 09 Jun 2026 - v1.11.6
**TimeCamp Timesheet**
* **new**: Sample calendar data for new users to make the first-run experience easier to understand
* **improvement**: Memory blocks are now visible in the edit time entry dialog
* **improvement**: Domains from visited URLs are handled like apps when reviewing computer activity
* **improvement**: Cleaner computer apps section and small edit dialog UI refinements
* **fix**: Choosing no task for an AI suggestion no longer restores the original suggested task in calendar view
* **fix**: Corrected suggested task names in AI proposals
* **fix**: Fixed empty early-morning gaps appearing when memory blocks are present
* **fix**: Accept and reject buttons no longer blink while interacting with AI suggestions
**Assistant (AI Agent)**
* **new**: Chat history support for easier follow-up across assistant conversations
* **improvement**: User message timestamps are available on hover
* **improvement**: Token usage is shown in chat
* **improvement**: Clearer guidance when AI is disabled and TimeCamp provider setup is needed
* **fix**: Prevented duplicate notifications from scheduled jobs
**Screen Time**
* **improvement**: Better memory display logic in the dashboard
### 04 Jun 2026 - v1.11.5
**TimeCamp Timesheet**
* **new**: More responsive AI suggestion interactions with clearer accept and reject animations
* **improvement**: Expand and collapse animations in task-grouped list view are smoother
* **improvement**: Calendar entry hover behavior is clearer and more stable
* **improvement**: Calendar view performance improvements for loading entries and visible day data
* **fix**: Clearer error feedback when accepting AI suggestions fails
**Assistant (AI Agent)**
* **improvement**: Summary prompts are integrated directly into suggestions for a cleaner chat experience
### 02 Jun 2026 - v1.11.4
**TimeCamp Timesheet**
* **new**: Task grouping in list view with expand/collapse controls for cleaner entry browsing
* **improvement**: Week view, date picker, and timeline controls got a UI polish for more consistent navigation
* **improvement**: Smoother animations and transitions across timesheet views
* **fix**: Accepted AI suggestions now appear correctly in the calendar view
* **fix**: Improved memory block creation flow and cleaned up the memory blocks UI
**Assistant (AI Agent)**
* **new**: Single-click summaries for faster activity review
* **improvement**: Chat can keep running when you switch tabs
* **improvement**: Better compact output for activity tool calls and updated translations
* **fix**: Improved handling of interrupted tool calls and duplicate visible messages
**Screen Time**
* **new**: Memory blocks added to the dashboard view
* **improvement**: Collapsible sections, transition effects, and small dashboard UI refinements
### 31 May 2026 - v1.11.3
**TimeCamp Timesheet**
* **improvement**: Larger and more comfortable edit entry window
* **fix**: Corrected default collapsed state of side bars in calendar view
### 31 May 2026 - v1.11.2
**TimeCamp Timesheet**
* **new**: Standalone edit entry window for easier time entry updates
* **new**: Manual edits to AI suggestions are now tracked to improve future proposals
* **improvement**: AI suggestions now use existing time entries as extra context for better accuracy
* **improvement**: Calendar zoom controls are smoother and your preferred zoom level is remembered
* **improvement**: Better tooltip behavior and clearer activity labels in the calendar view
* **fix**: More reliable merging of adjacent entries when overlapping entries are not allowed
* **fix**: Improved memory block generation to avoid creating blocks when there is no activity
**Assistant (AI Agent)**
* **new**: HTML widget support for richer chat responses
* **new**: Payload size guards for activity and OCR tools with clearer guidance for large queries
* **improvement**: Updated model and provider handling for more efficient suggestion generation
* **improvement**: Better guidance to use TimeCamp documentation when needed
### 31 May 2026 - v1.11.1
**TimeCamp Timesheet**
* **new**: Memory blocks line in calendar view with brief text overview
* **new**: Ability to expand bar with screen time in calendar by clicking on it
* **new**: Select specific apps when creating time entries from tracked activity by clicking CMD/Ctrl or Shift on app name
* **improvement**: Speed - better handling of TimeCamp entries with caching and cleaner creation flow
* **improvement**: Calendar, day column, and week view controls got a UX cleanup with smoother transitions
* **improvement**: App and memory bars can be collapsed
* **improvement**: Changed order of date picker buttons to be more intuitive
**Assistant (AI Agent)**
* **improvement**: Better agent guidance for skill installation and updated system instructions
* **improvement**: New tool call to get or edit memory blocks
* **fix**: Bash tool reliability improvements on macOS
**General**
* **fix**: Clearer memory block terminology in translations
### 30 May 2026 - v1.11.0
**AI**
* **improvement**: Switched to new unified API proxy
### 03 May 2026 - v1.10.9
**TimeCamp Timesheet**
* **new**: Add "Today" shortcut in calendar view
* **improvement**: Enhanced task search functionality
* **improvement**: Hide empty time gaps shorter than 2 minutes in list view to reduce visual clutter
* **improvement**: Better display format for small time blocks in the calendar view
* **improvement**: Improved clarity of timesheet settings
* **improvement**: Updated duration display format and enhanced suggestion labels
* **improvement**: Hide the "not tracking" red warning bar before the first computer activity of the day
* **fix**: Ensure accurate time entry suggestions by fixing adjacent entry merge logic
* **fix**: Reliable automatic task switching using keywords
* **fix**: Resolve race condition when rapidly deleting multiple time entries using keyboard shortcuts
**Screen Time**
* **new**: Added a privacy banner to emphasize local data protection
**Assistant (AI Agent)**
* **improvement**: Enhanced agent knowledge of local app data handling and privacy guidelines
### 27 Apr 2026 - v1.10.8
**System & Performance**
* **improvement**: Optimize performance by pausing background AI suggestions when the TimeCamp API is inaccessible (e.g. account inactive)
* **improvement**: Adjust throttling rate of background telemetry for better stability
### 26 Apr 2026 - v1.10.7
**TimeCamp Timesheet**
* TimeCamp instance endpoint configuration — support for custom server URLs
* AI suggestions now use task descriptions and keywords for more accurate proposals
* Option to restrict AI suggestions to last-level tasks only
* Periodic API authentication backoff — automatically slows down sync when account is suspended or inaccessible
* Improved error messages when account is suspended
* Fix: better error hint for 403 status guiding users to create a project
**Assistant (AI Agent)**
* Timestamps added to user messages in chat for better context in long-lived sessions
* `forceRefresh` option added to `getTasks` for fetching the latest task list from server
* Increased timeout for scheduled jobs with improved logging
* Fix: streamlined abort controller management to fix notifications on Windows
* Fix: scheduled job output now enforces plain text format
* Fix: updated system prompt to enhance user guidance on automations and skill discovery
* `/new` and `/reset` commands are now clickable links in chat
### 19 Apr 2026 - v1.10.6
**General**
* Global shortcut modifier changed from Cmd/Ctrl to Cmd+Shift / Ctrl+Shift for better consistency across platforms
* Default global shortcut key changed to disabled — prevents accidental triggers on fresh installs
* Settings migration improved to correctly handle shortcut values on update
### 18 Apr 2026 - v1.10.5
**TimeCamp Timesheet**
* Configurable AI and calendar snap intervals — fine-tune how AI suggestions and time blocks align
* Date header formatting improvements in day column view
* Background auto-switch — active timer automatically switches based on detected activity using tasks keywords (no AI required, by default disabled)
* Fix empty state - remove empty calendar overlay that was duplicated
* Fix Clockify timer functionality
**Calendar View**
* Current time indicator — see where you are in the day at a glance
* Auto-scroll to latest entry end time on open
* Layout and z-index fixes for improved display
**Assistant (AI Agent)**
* Desktop notification tool — agent can now send prominent on-screen alerts
* Enhanced notification handling for scheduled job messages
* Scheduled jobs can now use bash commands
**General**
* Updated default global shortcut key for consistency
### 01 Apr 2026 - v1.10.4
**App**
* Fixed second application instance not triggering the default action (e.g. show window) before terminating
* Removed legacy plain-text-timesheet plugin
* Security: updated vulnerable packages
### 29 Mar 2026 - v1.10.3
**TimeCamp Timesheet**
* Toggl integration — connect Toggl as an alternative time tracking provider alongside TimeCamp and Clockify
### 26 Mar 2026 - v1.10.2
**App**
* Activity tracking toggle added to system tray menu — pause and resume tracking without opening the app
### 22 Mar 2026 - v1.10.1
**TimeCamp Timesheet**
* Note button in Quick Start task picker — quickly add notes to selected task
* Favorites filter in Quick Start — toggle to show only your favorite tasks
* Pinned tasks in week view — pin frequently used tasks for easy access
* Configurable view options — choose which views to display in tabs
* Global keyboard shortcut to open the calendar timesheet tab
* Smarter task sorting in Quick Start
* Shake animation feedback when attempting to add a task without search input
* Refined task creation and selection logic in Quick Start
* Better empty state in week timesheet view
* Manually edited descriptions are no longer overwritten by auto-generation
* Corrected global shortcut label in Quick Start settings
**Assistant (AI Agent)**
* Configurable global shortcuts for agent actions
* Enhanced layout and responsiveness for tasks dialog
* Updated Claude Code provider integration
**General**
* Added missing translations
### 22 Mar 2026 - v1.10.0
**App**
* In-app update notifications — get notified when a new version is available without leaving the app
* Permission notification panels — accessibility and screen capture permission requests now shown as in-app notifications instead of system prompts
* Credits notification — see your AI credits status directly in the app if they are exhausted
* macOS permissions are no longer auto-prompted on startup — less intrusive onboarding experience
* Activity tracking replaces the old "track pause time" mechanic with a simpler toggle
* Upgraded to Electron 40 with multiple dependency updates
**Assistant (AI Agent)**
* Cache write tokens support for reduced API costs
* Automatic handling of AI models with forced reasoning
### 21 Mar 2026 - v1.9.15
**Calendar Timesheet**
* Clockify support — connect Clockify as an alternative time tracking provider alongside TimeCamp
* Create tasks directly from the Quick Start interface without leaving the app
* Export calendar entries to external formats
* Multiple time tracking provider support with unified settings
* Improved onboarding messaging and API key handling
* Toast notifications (via Sonner) for time entry actions — create, update, delete
* Task and project ID resolution in time entry mapping
* Time range label now correctly reflects actual entry times
**Assistant (AI Agent)**
* OpenAI-compatible provider support — use any OpenAI-API-compatible endpoint
* Smarter message handling and persistence across sessions
* Enhanced error handling for task and time entry tools
* PostHog analytics integration for better usage insights
**Screen Time**
* AI stats dashboard — shows time saved by AI, total AI entries, and active days with a hero banner
### 15 Mar 2026 - v1.9.14
**Assistant**
* New compaction engine (LosslessContext LCM) for smarter, token-efficient long conversations
* Job scheduling — create and manage recurring tasks directly from the chat
* Reload skills automatically when clearing the chat
**Calendar Timesheet**
* Week view: horizontal scroll detection and sticky column headers
* AI-powered merging of time entry descriptions for cleaner entries
* Favorite tasks — mark tasks as favorites with animations and list reordering in Quick Start
* Recently used tasks now include timestamps for smarter sorting
* Elapsed time display and timer controls added to Quick Start
* **fix**: Missing description parameter in Add Time Entry tool
### 9 Mar 2026 - v1.9.13
**Assistant**
* New `addTask` tool — create projects and tasks in TimeCamp directly from the chat
**Calendar Timesheet**
* Week view — browse and manage your time entries across the full week
* Manual refresh button and new UI elements for task management
### 8 Mar 2026 - v1.9.12
**Assistant**
* AI task suggestion — better task detection and description using time tracking agent with tool calling
* OCR data retrieval and statistics tools for Assistant
* Claude Code integration as an AI provider for Assistant
* Compaction to save tokens in longer conversations
* Multi-language support for Assistant system prompts
* Token optimization by limiting number of tasks sent to AI
* Enhanced typing animation with caret visibility control
* Ability to stop running bash commands in Assistant
* Problem with cmd/exec on Windows for some commands
**Calendar Timesheet**
* Nearly-sequential entry detection with improved calendar rendering
* Calendar layout improvements for overlapping entries
* Plugin name corrected in manifest
### 26 Feb 2026 - v1.9.11
* **new**: Auto-run mode setting — choose between 'Safe' (approve each tool) and 'Always Allow' for fully autonomous operation
* **new**: Share chat content as PNG, text, or copy to clipboard
* **new**: First-run welcome message with auto-send on initialization
* **improvement**: Smarter chat streaming with interruption handling and unique stream IDs to prevent race conditions
* **improvement**: Link safety checks in AI responses — external links are handled securely
* **improvement**: Better error messages and improved dark mode color contrast
* **fix**: Time entry snapshot storage now uses INSERT OR IGNORE to prevent duplicates
### 25 Feb 2026 - v1.9.10
* **new**: TimeCamp as a built-in AI provider — no external API key required, works out of the box
* **new**: Skills management — browse, install, and open skills directory directly from the chat
* **new**: Sliding suggestions and rotating words in chat input for quick-start prompts
* **new**: Add skills directly from the chat interface with a dedicated action
* **improvement**: Chat now supports multiple languages (translations for EN and PL)
* **improvement**: New chat button and auto-focus on input when window regains focus
* **improvement**: Model and provider info displayed dynamically in chat header
* **improvement**: Bundled skills are automatically loaded on plugin initialization
* **fix**: Skills marketplace link updated to skills.sh
### 23 Feb 2026 - v1.9.9
* **new**: Skills system — load custom `.md` skill files from a configurable directory to extend Tic Agent's capabilities
* **new**: Timer tools — start, stop, and check timer status directly from the AI chat
* **new**: Auto-run mode configuration — choose between 'safe' (approval required) and 'run-everything' modes
* **new**: Copy message and read aloud actions on assistant responses
* **improvement**: Step count limit increased from 5 to 50 for longer multi-step tasks
* **improvement**: Chat reset clears history and reloads skills
* **improvement**: Dark mode styling improvements
### 21 Feb 2026 - v1.9.8
* **new**: Tic Agent — AI chat assistant for managing time entries (experimental) 🤖 🔥🔥🔥 (enable it in settings)
### 21 Feb 2026 - v1.9.7
* **improvement**: Screen time view now defaults to 'today' with reordered date range buttons
* **improvement**: Screenshots are now disabled by default for better privacy
* **improvement**: Calendar view button renamed to 'Start' with sign-up link for new users
* **improvement**: Reordered tabs for better navigation flow
* **improvement**: Added padding to table view for cleaner layout
### 20 Feb 2026 - v1.9.6
* **fix**: Billable flag now saves correctly on time entries
### 17 Feb 2026 - v1.9.5
* **new**: Option to disable global shortcut in settings
* **new**: Search text highlighting in Quick Start for easier task finding
* **improvement**: Screen time app grouping only activates when there are more than 20 items
### 11 Feb 2026 - v1.9.4
* **new**: Screen time plugin — track time spent in applications and websites
* **new**: Favicon display for websites in app usage list
* **fix**: Visual overlap issue for short time entries in calendar layout
### 10 Feb 2026 - v1.9.3
* **new**: Quick link to create new project or task during quick start
* **new**: Onboarding flow now completes on Enter key press for faster setup
* **fix**: Improved error handling for API token validation and network issues
### 9 Feb 2026 - v1.9.2
* **new**: CSV export for table view — download your time entries as spreadsheet
* **improvement**: Smarter AI proposal handling — marks entries as covered, restores entries when proposals are dismissed to save LLM tokens
* **fix**: Calendar layout and positioning improvements for overlapping entries
* **fix**: Running timer overlay now clickable for quick entry interaction
* **fix**: Better error messages when API calls fail
### 9 Feb 2026 - v1.9.1
* **new**: Table view powered by AG Grid for browsing and editing time entries
* **new**: Drag-and-drop in calendar — move and resize entries with edge snapping
* **new**: AI now suggests multiple tasks per time entry for faster selection
* **new**: Auto-merge adjacent time entries with similar activities in the background
* **new**: Real-time updates for AI suggestions in calendar and timeline views
* **improvement**: Instant task picker opens right after creating a new time entry
* **improvement**: Description field auto-focuses after task selection
* **improvement**: AI suggestions only run at 30-minute boundaries to reduce API calls
* **improvement**: Caching for time entries and timer status for better performance
* **improvement**: Smarter token usage — limits tasks sent to AI to save costs
* **improvement**: Automatic cleanup of stale and duplicate pending proposals
* **improvement**: Renamed plugins for clarity — "AI Summary" and "AI Table"
* **fix**: AI suggestions reappear correctly when a time entry is deleted
* **fix**: Suggested tasks now display reliably in all time entry views
* **fix**: Overlap detection uses actual end times for accuracy
* **fix**: Time entries clamped to valid ranges to prevent API errors
* **fix**: Background tickers debounced to prevent redundant API calls
### 28 Jan 2026 - v1.9.0
* **improvement**: Moved list and timeline views to separate tabs
* **improvement**: New setting to disable screen OCR
* **improvement**: Mini widget improved to show time of running timer
* **improvement**: Mini widget added ability to pause and resume timer
* **fix**: Default action when clicking on the app icon was not working
* **fix**: App was starting with wrong version number
* **fix**: Dark mode was not working properly
### 20 Jan 2026 - v1.8.3
* **new**: Customizable global shortcut for starting timers
* **fix**: Timeline interaction improvements for better task selection and dragging
* **fix**: Task breadcrumb display in edit modal
* **improvement**: Improved task suggestion prompt clarity and description examples for LLM
### 12 Jan 2025 - v1.8.2
* fix: Timeline will work on days without computer activity
* improvement: Open timeline from calendar
* chore: Store snapshot of manual and automatic time entries in local db to improve tasks matching
### 12 Jan 2025 - v1.8.1
* **new**: Added timeline view
* **fix**: Time entry suggestions now properly respect user settings when disabled
* **improvement**: Widget is now disabled by default for new users
* **improvement**: Persist activities expanded state in edit time entry dialog
### 10 Jan 2025 - v1.8.0
* **new**: Unified single-window interface with all views accessible in one place for improved discoverability
* **fix**: Memory leaks on MacOS and Windows causing crashes
* **fix**: Various stability improvements
* **fix**: Fixed text summary occasionally displaying incorrect computer time
### 30 Nov 2025 - v1.7.0
* **chore**: added Sentry for error logging
* **chore**: use separate threads for better performance
### 23 Nov 2025 - v1.6.6
* **new**: added day text summary feature with custom styles (professional, funny, technical)
* **improvement**: added button to regenerate daily timesheet
* **improvement**: better performance for TimeCamp task selection
### 23 Nov 2025 - v1.6.5
* **fix**: Daily Timesheet will make better time entries suggestion - less granular
### 23 Nov 2025 - v1.6.4
* **fix**: Daily Timesheet table not loading properly
### 17 Nov 2025 - v1.6.3
* **new**: timer widget
* **improvement**: better performance
* **fix**: many small fixes, especially in onboarding
### 12 Nov 2025 - v1.6.2
* **improvement**: now time entries suggestions need to be approved before sending
* **improvement**: UX in calendar view
### 7 Nov 2025 - v1.6.0
* **new**: quick start a task window with global shortcut cmd/ctrl+e
* **improvement**: shortcuts to zoom windows and open settings cmd/ctrl+,
* **fix**: problem when showing daily timesheet table with automatic summary of day
* **fix**: many small fixes
### 4 Nov 2025 - v1.5.1
* **fix**: many small fixes
### 1 Nov 2025 - v1.5.0
* **new**: textual overview of your day (enable it in settings)
* **new**: choose default action when clicking on the app icon
* **new**: get browser urls as hints to fill your timesheet (stays private only on your computer)
* **improvement**: MacOS accessibility permissions check
* **improvement**: more generous free LLM tokens (for limited period of time)
* **fix**: many small fixes
### 27 Oct 2025 - v1.4.4
* **new**: Onboarding in timecamp timesheet
* **new**: Ability to zoom calendar view
* **improvement**: MacOS menu bar icons now follow the standard with automatic color
* **improvement**: Many many (over 30) UI improvements & tweaks
### 4 Aug 2024 - v1.0.0
* **new**: First line of code, hello 👋🏻👨🏻🍼