webxsid/crona
webxsid/crona has 73 GitHub stars and 3 forks. GitHot measured +1 in 7 days and +2 in 15 days. Last checked 2026-11-15 20:09 UTC. Last push 2026-11-04.
Measured star growth
- in 24h
- Update delayed
- in 7 days
- +1
- in 15 days
- +2
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Local-first work tracking for people who live in the terminal.
Developer ToolsREADME.md
OriginalCrona
Crona is a local-first work tracker for developers. It combines a terminal UI, a scriptable CLI, and a background local daemon into one workflow for planning work, tracking focus sessions, reviewing momentum, and exporting structured artifacts.
Managed package installers are the preferred distribution path:
- Homebrew on macOS and Linux
- Nix (flake) on Linux and Apple silicon Macs
- Scoop on Windows
- GitHub Releases as the canonical binary source
Use docs/install.md for installation and docs/migration.md when you need to switch install methods or release channels. Destination-specific migration guides live in the migration section of the docs.
The repository is a Go monorepo with four main modules:
kernel: internal source tree for the background daemon, SQLite store, timer, IPC, and update checkstui: Bubble Tea terminal UIcli: scriptable commands and local daemon control flowsshared: shared types, config, protocol, and utilities
Screenshots
Beta UI preview
These captures show the v1.10.0-beta.1 interface.







Existing screenshots



Quick Start
See the full installation guide in docs/install.md.
With Nix, install straight from this repository's flake:
nix profile add github:webxsid/crona#crona # stable
nix profile add github:webxsid/crona#crona-beta # beta
Update with nix profile upgrade crona (or crona-beta).
These commands need flakes. If Nix reports that nix-command or flakes is disabled, add experimental-features = nix-command flakes to ~/.config/nix/nix.conf, or pass --extra-experimental-features 'nix-command flakes' to each command. On older Nix releases that lack nix profile add, use nix profile install.
If you are migrating from the install script, another package manager, or a beta channel, use docs/migration.md before reinstalling.
Runtime notes:
- local alerts are emitted by the background daemon, not the TUI process
- scheduled reminders only fire while the background daemon is running
- the
Summaryview andcrona summaryare read-only at-a-glance surfaces; the TUI Summary also includes focus stats and an interactive score calendar via[c]; useDailywhen you want to plan or make changes interactively - the Daily view adapts cleanly to smaller terminals with compact issue rendering and shorter pane hints
- the Wellbeing view includes Momentum detail with current bucket metadata and contributor breakdowns
- the TUI owns the terminal tab title while it is running and shows active session context when focused
- PDF export depends on local renderer tooling; see docs/install.md
Launch the TUI:
crona
Get a quick read-only summary from the CLI:
crona summary
crona summary --week
crona summary --last-x-days 7
Inspect the daemon from the CLI:
crona daemon attach --json
crona daemon status --json
crona daemon info --json
The command group is named daemon because it controls the internal daemon process. User-facing docs generally call it the daemon or local daemon.
Generate shell completions:
crona completion zsh
crona completion bash
crona completion fish
macOS Companion
The Crona macOS companion is a native menu-bar app that connects to your local Crona daemon. It’s still in beta and changing quickly, so expect rough edges and occasional changes to the UI, APIs, and installation process.
Documentation
- Docs Index
- Concepts
- Install
- Migration
- Development
- Contributing
- Release Process
- Socket API
- Changelog
- Feature Design
Operational references:
Support And Updates
Public support is available through these links:
- Bugs: UserJot
- Feedback and roadmap: UserJot
- Release updates: Releases
- Release process: docs/release.md
Generate a support bundle from the TUI Support view before filing a bug when possible.