分支	状态
master

RTW - Rust 时间监视器

命令行界面（CLI）时间跟踪器。

CLI 使用稳定，底层 API 不稳定。

注意：此软件是作为我的生产力工具开发的，而非面向消费者的资源。我无法投入大量时间来维护此软件，但如果出现问题，我将尽力提供支持 =)。

本项目深受 Timewarrior 的启发。

对于功能丰富的稳定版 CLI 时间跟踪器，请使用 Timewarrior: https://timewarrior.net/.

为什么还需要另一个时间跟踪工具？

1. 学习 Rust
2. 我曾经在使用另一个时间跟踪工具时丢失了一个月的数据（数据库损坏）...再也不了！

安装

支持的操作系统：Linux、MacOS、Windows

CI 在 ubuntu-latest、macos-latest、windows-latest 上运行。

注意：Windows 支持仅为实验性。某些功能可能在 Windows 上不受支持。

Cargo

cargo install rtw

从源代码构建

rtw 使用 Rust 1.42.0（稳定版）或更高版本编译。

克隆并从源代码构建

git clone https://github.com/PicoJr/rtw.git
cd rtw
cargo build --release

从二进制文件（仅限 Linux）

从 发布页面 下载相应的存档。

Shell 完整性（Bash、Zsh、Fish、Powershell、Elvish）

请参阅 shell 完整性。

Starship 提示集成

# starship.toml
[custom.rtw]
command = """ rtw status --format "{ongoing} {human_duration}" """
when = "test -f ~/.rtw.json"
shell = ["bash", "--noprofile", "--norc"]

~/.rtw.json 是 rtw 存储正在进行的活动的文件

变更日志

请参阅 变更日志 了解发布历史。

基本用法

开始跟踪活动

示例

rtw start "learn rust"

示例输出

Tracking learn rust
Started  2019-12-25T19:43:00

显示当前活动

rtw

示例输出

Tracking learn rust
Total    01:15:00

停止当前活动

rtw stop

示例输出

Recorded learn rust
Started 2019-12-25T19:43:00
Ended   2019-12-25T21:00:00
Total   01:17:000

显示当天活动摘要

rtw summary

示例输出

read the doc 2019-12-25T11:49:30 2019-12-25T11:53:36 00:04:246
eat cookies  2019-12-25T12:08:49 2019-12-25T12:12:14 00:03:204

显示当天时间线

rtw day

示例输出（可能有所不同）

还有更多？

有关更多详细信息，请参阅 完整用法。

配置

RTW不会为您创建配置文件，但它会在以下位置（按此顺序）寻找配置文件：

1. $XDG_CONFIG_HOME/rtw/rtw_config.json
2. $HOME/.config/rtw/rtw_config.json
3. $XDG_CONFIG_HOME/.config/rtw_config.json
4. $HOME/.config/rtw_config.json

请查看example文件夹以获取默认配置文件。

实现

RTW依赖于json文件进行持久化。

默认位置是家目录(~)。

~/.rtw.json  # stores current activity
~/.rtwh.json # stores finished activities

当前没有文件锁定机制：同时运行多个rtw命令可能会导致不确定的行为。

类似工具

• timewarrior
• watson
• jobrog
• doug
• timetracking
• ...