https://github.com/previousnext/tl-go

Command line time logger
https://github.com/previousnext/tl-go

go-tools

Last synced: 3 months ago
JSON representation

Command line time logger

• Host: GitHub
• URL: https://github.com/previousnext/tl-go
• Owner: previousnext
• License: gpl-2.0
• Created: 2026-01-28T00:56:22.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2026-01-29T00:38:00.000Z (4 months ago)
• Last Synced: 2026-01-29T13:31:15.628Z (4 months ago)
• Topics: go-tools
• Language: Go
• Homepage:
• Size: 9.23 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# TL

A command-line tool for logging time to Jira Worklogs.

## Setup

You will need your Jira URL, username, and an API token to authenticate with Jira. You can generate an API token from your Atlassian account.

```

tl setup \

  --jira-url https://your-domain.atlassian.net \

  --username yourusername \

  --token yourapitoken

```

## Usage

Basic workflow example:

```

tl add PROJ-123 2h "Worked on feature X"

tl review

tl send

```

Command reference:

```

USAGE

    tl [command] [--flags]

COMMANDS

    add   [description] [--flags]  Add a time entry

    alias [command]                           Add, list, and delete command aliases.

    delete                                Delete a time entry

    edit  [--flags]                       Edit a time entry

    issues [--flags]                          List recent issues

    list [--flags]                            List all time entries

    migrate                                   Migrate the database schema to the latest version.

    review                                    Review unsent time entries

    send                                      Send time entries to Jira

    setup [--flags]                           Setup tl database and configuration

    show                                  Show details of a time entry

    summary [--flags]                         Show a summary of time spent per project category

```

### Adding bash completion

To enable bash completion for `tl`, you can run the following command on Ubuntu and restart your terminal:

```

tl completion bash > ~/.local/share/bash-completion/completions/tl.bash

```

### Acknowledgements

This project was inspired by [larowlan/tl](https://github.com/larowlan/tl) which is written in PHP and does much more than this version.