⏱️ County

Track time spent on every project you open in VS Code — powered by Rust.

Features

	Feature	Description
⏱️	Auto Tracking	Timer starts automatically when you open a project
📊	Project Rankings	See your top projects sorted by total time
🔘	Per-Project Toggle	Enable/disable tracking per project
💤	Idle Detection	Pauses when you step away — no phantom time
📌	Status Bar	Always-visible elapsed time in the bottom bar
🗂️	Sidebar Panel	Dedicated activity bar icon with project list
💾	Persistent Storage	Data survives across sessions and restarts

Commands

Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and type:

Command	What it does
`County: Display Time`	Shows current project time + ranked project list
`County: Show Settings`	Opens County settings
`County: Toggle Timer`	Enable/disable timer for any tracked project

Settings

Setting	Default	Description
`county.idleTimeoutSeconds`	`300`	Seconds of inactivity before the timer pauses
`county.saveIntervalSeconds`	`30`	How often data is persisted to disk
`county.showStatusBar`	`true`	Show/hide the status bar timer

Getting Started

Prerequisites

Rust toolchain
Node.js >= 18

Build

# Install dependencies
npm install
cd native && npm install && cd ..

# Build everything (Rust + TypeScript)
npm run build

Run in Development

Press F5 in VS Code — it launches an Extension Development Host with County loaded.

Package for Distribution

npm run package
# Produces county-0.1.0.vsix
code --install-extension county-0.1.0.vsix

Note: The .vsix contains a platform-specific native binary. Build on each target OS for cross-platform support.

Architecture

County/
├── native/                  Rust core (napi-rs)
│   ├── Cargo.toml
│   ├── build.rs
│   └── src/lib.rs           Storage, stats, duration formatting
│
├── src/                     TypeScript extension
│   ├── extension.ts         Lifecycle, timers, idle detection
│   ├── commands.ts          Command palette handlers
│   ├── statusBar.ts         Status bar widget
│   ├── projectsView.ts     Sidebar tree view
│   └── types.ts             Shared type definitions
│
├── media/                   Icons
│   ├── icon.svg             Activity bar icon
│   └── marketplace-icon.png Marketplace listing icon
│
├── package.json             Extension manifest
└── tsconfig.json

Layer	Responsibility
Rust	JSON persistence, project data, time formatting, rankings
TypeScript	VS Code API, timer intervals, idle detection, UI components

License

MIT

County

NNKtv28