Crona

Crona is a local-first work tracker for developers. It combines a terminal UI, a scriptable CLI, and a background local engine into one workflow for planning work, tracking focus sessions, and exporting structured artifacts.

The repository is a Go monorepo with four main modules:

• kernel: background local engine, SQLite store, timer, IPC, update checks
• tui: Bubble Tea terminal UI
• cli: scriptable commands and local engine control flows
• shared: shared types, config, protocol, and utilities

Screenshots

Quick Start

See the full installation guide in docs/install.md.

Runtime notes:

• local alerts are emitted by the background engine, not the TUI process
• scheduled reminders only fire while the background engine is running
• 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

Inspect the local engine from the CLI:

crona kernel attach --json
crona kernel status --json
crona kernel info --json

The command group is named kernel because it controls the internal engine process. User-facing docs generally call it the local engine or background engine.

Generate shell completions:

crona completion zsh
crona completion bash
crona completion fish

Release Channels

• stable is the preferred channel for general users.
• prerelease remains available for staged validation and faster iteration.
• v1.2.2 is the current stable release.

Documentation

• Docs Index
• Concepts
• Install
• Development
• Contributing
• Release Process
• Socket API
• Changelog
• Feature Design

Operational references:

• Notification and alert behavior
• PDF rendering support

Support And Updates

Public support surfaces live on GitHub:

• Bugs: Issues
• Help and ideas: Discussions
• Release updates: Releases
• Release process: docs/release.md

Generate a support bundle from the TUI Support view before filing a bug when possible.

License

MIT