# Quickstart

> timetrace - Time Tracking

- Skill: `javimosch/quickstart-2023` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/quickstart-2023`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/quickstart-2023/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/quickstart-2023

---

# timetrace - Time Tracking

## Overview
timetrace is a simple CLI for tracking your working time. Track time by project, generate reports, and integrate with shell prompts.

## Quick Start

### Start tracking time
```bash
sc timetrace start tracking <project>
```

### Stop tracking time
```bash
sc timetrace stop tracking
```

### Passthrough to timetrace CLI
```bash
sc timetrace _ <timetrace-args>
```

## Key Features

- **Simple Tracking**: Start and stop time tracking for projects
- **Project Management**: Create and manage projects
- **Reports**: Generate time reports
- **Shell Integration**: Integrate with Starship and other prompts
- **Multiple Install Methods**: Homebrew, Snap, AUR, Scoop, Docker, Binary
- **Configurable**: 12-hour/24-hour clock, decimal hours, editor settings

## Installation

```bash
brew install timetrace
```

Also available via:
- Snap
- AUR (Arch Linux)
- Scoop (Windows)
- Docker
- Binary

## Usage Examples

### Start tracking
```bash
timetrace start my-project
```

### Stop tracking
```bash
timetrace stop
```

### Check status
```bash
timetrace status
```

### Create project
```bash
timetrace create project my-project
```

### List projects
```bash
timetrace list projects
```

### Generate report
```bash
timetrace report
```

## Notes

- Run `timetrace --help` to see all available commands
- Supports shell integration with Starship
- Can be configured for 12-hour or 24-hour clock