PHPackages                             sugarcraft/sugar-tick - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. sugarcraft/sugar-tick

ActiveProject[CLI & Console](/categories/cli)

sugarcraft/sugar-tick
=====================

Privacy-first coding-time tracker — port of Rtarun3606k/TakaTime on the SugarCraft stack.

00PHP

Since Jun 29Pushed 3w agoCompare

[ Source](https://github.com/sugarcraft/sugar-tick)[ Packagist](https://packagist.org/packages/sugarcraft/sugar-tick)[ RSS](/packages/sugarcraft-sugar-tick/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependenciesVersions (2)Used By (0)

[![sugar-tick](.assets/icon.png)](.assets/icon.png)

SugarTick
=========

[](#sugartick)

[![CI](https://github.com/detain/sugarcraft/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/detain/sugarcraft/actions/workflows/ci.yml)[![codecov](https://camo.githubusercontent.com/380ff05b7d5686843953badb971942a5ccc3870bccb1fb0be82b14d79b504b64/68747470733a2f2f636f6465636f762e696f2f67682f64657461696e2f737567617263726166742f6272616e63682f6d61737465722f67726170682f62616467652e7376673f666c61673d73756761722d7469636b)](https://app.codecov.io/gh/detain/sugarcraft?flags%5B0%5D=sugar-tick)[![Packagist Version](https://camo.githubusercontent.com/660926eef5a7cd2a20d3fcf08d1abdaba5827906905b551c2bf89592c64a463a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f737567617263726166742f73756761722d7469636b3f6c6162656c3d7061636b6167697374)](https://packagist.org/packages/sugarcraft/sugar-tick)[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE)[![PHP](https://camo.githubusercontent.com/e78ffc83837c0d12647811a7fd1910c3cbeae04988de94bb4fd5b67e0874696a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d254532253839254135382e312d3838393262662e737667)](https://www.php.net/)

[![demo](.vhs/dashboard.gif)](.vhs/dashboard.gif)[![push demo](.vhs/push.gif)](.vhs/push.gif)

Privacy-first coding-time tracker — port of [`Rtarun3606k/TakaTime`](https://github.com/Rtarun3606k/TakaTime). Storage is JSONL on local disk (no cloud, no MongoDB), the dashboard is a SugarCharts-driven TUI that reads it.

Run it
------

[](#run-it)

```
# write a heartbeat from your editor (one-shot CLI):
sugar-tick push    [duration]

# open the dashboard:
sugar-tick
```

By default heartbeats land in `$XDG_DATA_HOME/sugar-tick` (or `~/.local/share/sugar-tick`). Override with `SUGARTICK_DIR=...`.

Keys (dashboard)
----------------

[](#keys-dashboard)

KeyAction`←`Shift the 7-day window back`→`Shift forward (to today)`r`Reload from disk`q` / `Esc`QuitArchitecture
------------

[](#architecture)

FileRole`Heartbeat`Value object — one activity sample (project, language, file, duration).`Store`JSONL-backed reader / appender. One file per day under the data dir.`Stats`Pure folder — totals per project / language + per-day timeline buckets.`Dashboard`SugarCraft Model — renders the report, ←/→ shifts the window, r reloads.`Renderer`View — header + ranking panes side-by-side + Sparkline timeline (SugarCharts).The Store is intentionally append-only at the file level, so editor plug-ins can `>>` echo a JSON line directly without coordinating with the dashboard. The dashboard reads at `r` / on launch / when the day shifts — never holds a file lock.

Shared foundations
------------------

[](#shared-foundations)

sugar-tick uses [candy-async](https://github.com/detain/sugarcraft/tree/master/candy-async) for cancellation support in async write operations.

Test
----

[](#test)

```
composer install
vendor/bin/phpunit
```

###  Health Score

20

—

LowBetter than 12% of packages

Maintenance62

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity13

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/b1036e0717211b8030b83cbe729e8ba6ba442fdbd5285fb97a39d7dcfe339342?d=identicon)[detain](/maintainers/detain)

---

Top Contributors

[![detain](https://avatars.githubusercontent.com/u/1364504?v=4)](https://github.com/detain "detain (91 commits)")

---

Tags

candycorecomposerphpsugarcraftterminaltui

### Embed Badge

![Health badge](/badges/sugarcraft-sugar-tick/health.svg)

```
[![Health](https://phpackages.com/badges/sugarcraft-sugar-tick/health.svg)](https://phpackages.com/packages/sugarcraft-sugar-tick)
```

###  Alternatives

[illuminate/console

The Illuminate Console package.

13046.0M6.8k](/packages/illuminate-console)[styleci/cli

The CLI tool for StyleCI

71470.5k9](/packages/styleci-cli)[winbox/args

Windows command-line formatter

20720.9k21](/packages/winbox-args)[mallardduck/laravel-traits

A collection of useful Laravel snippets in the form of easy to use traits.

136.2k2](/packages/mallardduck-laravel-traits)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)