twe

KO | EN

gitlite — search

#javascript #react #go #android #machine-learning #deep-learning #nodejs #awesome #cli #kubernetes #vue #openai #ios #open-source

(★ 17)

Timewarrior extension for power users, including an interactive TUI and a Go package for writing your own extensions.

twe Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# twe

Timewarrior extensions for power users, including an interactive TUI and a Go package for writing your own extensions.

## Installation

Install the executable and necessary extensions using `make`:

```
make install
```

## Usage

### Edit

![Edit Demo](https://raw.githubusercontent.com/kgoettler/twe/main/img/edit.gif)

`twe edit` runs an interactive TUI for editing Timewarrior data.  Updates are committed to Timewarrior as you make them. Use the following controls to interact with your data:

- `h/j/k/l` (or arrow keys) to move around the table. 
- `a` to add a new interval.
- `d` to delete the currently selected interval. 
- `u` to undo the last edit.
- `Enter/e` to edit the currently selected field.
- `Enter/Esc` when finished editing the currently selected field.

You can also specify a day to edit using a subset of [Timewarrior's date syntax](https://timewarrior.net/docs/dates/):

```bash
# Specify a relative date
twe edit today
twe edit tomorrow
twe edit yesterday

# ... or a specific day of the current week
twe edit sunday
twe edit sun

# ... or a specific date
twe edit 2025-01-01
twe edit 20250101
```

### Timecard

![Timecard Demo](https://raw.githubusercontent.com/kgoettler/twe/main/img/timecard.gif)

`twe timecard` prints a report of the hours / day dedicated to each tag within the specified time range. Supports [Timewarrior's date syntax](https://timewarrior.net/docs/dates/) for specifying time ranges.

```bash
# Timecard from the current week
twe timecard

# Timecard from last week
twe timecard :lastweek

# Timecard from specified date range
twe timecard 2026-01-01 - 2026-01-08
```

By default `twe timecard` rounds all durations _up_ to the nearest 15-minute billing increment. You can adjust the increment via the `--increment` flag:

```bash
# Round up to the nearest 6th minute (0.1 hours)
twe timecard --increment 6
```

Use the `--total-row` flag to add a row showing the total time recorded during each day. Use the `--total-col` flag to add a column showing the total time recorded for each tag throughout the specified dates:

### Import

`twe import` allows you to import a JSON-formatted array of intervals from into Timewarrior. Useful for importing intervals made in another system into Timewarrior, or even copying intervals from one `TIMEWARRIORDB` to another.

```bash
# Import from a file
twe import -f week.json

# ...or from STDIN
timew export :week | vipe | twe import
```

## Package

Documentation for the Golang package is available on [pkg.go.dev](https://pkg.go.dev/github.com/kgoettler/twe/pkg/timewarrior)

twe

twe Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

twe

twe Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README