trackWork

A console-based time tracking application built with Rust featuring a terminal UI.

⚠️ Early Development Status: This project is in very early stages of development. Many features are experimental and may not work reliably. Expect bugs, incomplete functionality, and breaking changes. Use at your own risk!

Features

• Terminal UI: Clean, intuitive interface built with ratatui
• Time Entry Management: Create, edit, delete, and reorder time entries
• Navigation: Easy keyboard-driven navigation
• Daily Views: View and track entries by date
• Running Timers: Start entries without an end time and stop them later
• Duration Tracking: Automatic calculation and display of time durations
• Timeline Visualization: Vertical bar chart with fixed time resolution (1, 2, 5, or 10 minutes per row)
• JIRA Integration: Link entries to JIRA issues and open them directly
• Weekly Statistics: Aggregated time tracking by issue or description
• Clipboard Integration: Copy durations and work logs
• Persistent Storage: SQLite database for reliable data storage
• Date Navigation: Browse entries across different days
• What's New Screen: Shows new features on version updates

Installation

Build from source

cargo build --release

The binary will be available at target/release/trackWork

Run

cargo run --release

Usage

Keyboard Shortcuts

Normal Mode

• n - Create new time entry
• e - Edit selected entry
• d - Delete selected entry (requires confirmation)
• Shift+D - Force delete selected entry (no confirmation)
• s - Stop running entry (or restart stopped entry)
• Shift+S - Open settings
• c - Copy selected entry duration to clipboard
• l - Open JIRA issue in browser and copy duration
• Shift+L - Toggle logged status for entry
• o - Open worklog
• ↑/↓ - Navigate between entries
• Ctrl+↑/↓ or Shift+↑/↓ - Reorder entries (move up/down)
• ←/→ - Change date (previous/next day)
• Esc - Clear status messages
• q - Quit application

Edit Mode

• Type to enter data in the current field
• Tab - Move to next field (Description → Start Time → End Time → Issue Key)
• ↑/↓ - Increment/decrement time in time fields
• Enter - Save entry
• Esc - Cancel and return to normal mode
• Backspace - Delete character

Create Mode

• Type to enter data in the current field
• Tab - Move to next field (Description → Start Time → End Time → Issue Key)
• ↑/↓ - Navigate suggestion list (for descriptions/issue keys)
• Enter - Save entry
• Esc - Cancel and return to normal mode
• Backspace - Delete character

Confirm Delete Mode

• y - Confirm deletion
• n or Esc - Cancel deletion

What's New Screen

• Enter or Esc - Close and return to dashboard

Time Format

Enter times in 24-hour format: HH:MM (e.g., 09:30, 14:45)

Leave the end time empty to create a running timer.

Data Storage

The application stores all data in ~/.timetrack.db (SQLite database).

Project Structure

src/
├── main.rs       # Application entry point and event loop
├── app.rs        # Core application logic and state management
├── db.rs         # Database operations and SQLite interface
├── models.rs     # Data models (TimeEntry)
└── ui.rs         # Terminal UI rendering (separated from business logic)

Architecture

The application follows a clean separation of concerns:

• UI Layer (ui.rs): Handles all rendering and display logic
• App Layer (app.rs): Manages application state and user interactions
• Data Layer (db.rs, models.rs): Database operations and data structures

This separation makes the codebase maintainable and testable.

Example Workflow

1. Launch the application
2. Press n to create a new entry
3. Enter description (e.g., "Client meeting")
4. Tab to start time, enter 09:00
5. Tab to end time, leave empty for running timer (or enter 10:30)
6. Tab to issue key field, optionally enter JIRA issue (e.g., "PROJ-123")
7. Press Enter to save
8. Use ↑/↓ to select entries
9. Press s to stop a running timer
10. Press l to open JIRA issue and copy duration
11. Press c to copy duration to clipboard
12. Use Ctrl+↑/↓ to reorder entries
13. Use ←/→ to view different days
14. Press Shift+S to configure settings (JIRA URL, colors)

Dependencies

• ratatui - Terminal UI framework
• crossterm - Cross-platform terminal manipulation
• rusqlite - SQLite database interface
• chrono - Date and time handling
• anyhow - Error handling
• dirs - Home directory detection

License

MIT