Introduction

Coderoller is a blazingly fast, privacy-first background daemon and CLI tool that meticulously tracks your coding activity. Unlike traditional cloud-based trackers, it stores everything locally, keeping your productivity data exclusively in your hands.

Why Coderoller?

Most modern time-tracking tools treat your data as a commodity. They sync every keystroke to their servers, charge monthly subscriptions, and often consume a significant amount of system resources with bulky Electron apps.

We built Coderoller to be different. It runs silently in the background with minimal overhead, requiring zero manual configuration after the initial setup. By automatically watching your local .git repositories and IDE activity, it maps your time perfectly without you ever clicking a "start" button.

Key Features

• Local-first: All data is stored in a highly optimized local SQLite database (~/.coderoller/db.sqlite).
• Zero Configuration: Auto-detects projects based on Git repositories.
• Sub-millisecond CPU Usage: Written entirely in Rust. Uses less than 0.1% CPU and ~12MB of RAM.
• Universal IDE Support: Seamlessly hooks into VSCode, JetBrains, Neovim, and Xcode.

Quick Start

You can install Coderoller globally via NPM:

Once installed, simply start the daemon: