@vibecoded/work 0.0.2 → 0.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +86 -8
- package/package.json +5 -2
package/README.md
CHANGED
|
@@ -1,15 +1,93 @@
|
|
|
1
|
-
# work
|
|
1
|
+
# @vibecoded/work
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Minimal local time-tracking CLI (Bun + TypeScript).
|
|
4
|
+
Stores data per project in `data/<projectId>/` with:
|
|
5
|
+
- `tasks.json`
|
|
6
|
+
- one CSV per month: `YYYY-MM.csv`
|
|
4
7
|
|
|
5
|
-
|
|
6
|
-
|
|
8
|
+
## Install
|
|
9
|
+
|
|
10
|
+
```typescript
|
|
11
|
+
bun add -g @vibecoded/work
|
|
12
|
+
npm install -g @vibecoded/work
|
|
13
|
+
````
|
|
14
|
+
|
|
15
|
+
## Data location
|
|
16
|
+
|
|
17
|
+
Default: `~/.work`
|
|
18
|
+
|
|
19
|
+
Override with:
|
|
20
|
+
|
|
21
|
+
```typescript
|
|
22
|
+
work --dir ./my-work-data status
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Commands
|
|
26
|
+
|
|
27
|
+
### `work init`
|
|
28
|
+
Initialize data files.
|
|
29
|
+
|
|
30
|
+
```typescript
|
|
31
|
+
work init
|
|
7
32
|
```
|
|
8
33
|
|
|
9
|
-
|
|
34
|
+
### `work on [project] [task...]`
|
|
35
|
+
Start tracking.
|
|
36
|
+
|
|
37
|
+
- If `project` is missing: pick or create a project
|
|
38
|
+
- If `task` is missing: pick or create a task
|
|
39
|
+
- If already tracking something: asks to switch (use `--yes` to auto-switch)
|
|
40
|
+
|
|
41
|
+
```typescript
|
|
42
|
+
work on
|
|
43
|
+
work on Project
|
|
44
|
+
work on Project "Fix billing bug"
|
|
45
|
+
work on Project2 "New task" --yes
|
|
46
|
+
```
|
|
10
47
|
|
|
11
|
-
|
|
12
|
-
|
|
48
|
+
### `work off`
|
|
49
|
+
Stop current tracking and write to the month CSV.
|
|
50
|
+
```typescript
|
|
51
|
+
work off
|
|
13
52
|
```
|
|
53
|
+
### `work status`
|
|
54
|
+
Show current tracking (if any).
|
|
55
|
+
```typescript
|
|
56
|
+
work status
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
### `work projects`
|
|
60
|
+
List projects.
|
|
61
|
+
|
|
62
|
+
```typescript
|
|
63
|
+
work projects
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### `work tasks [project]`
|
|
67
|
+
List tasks for a project (by usage).
|
|
68
|
+
|
|
69
|
+
- If `project` is missing: pick a project
|
|
70
|
+
```typescript
|
|
71
|
+
work tasks
|
|
72
|
+
work tasks Project
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
### `work info [project] [YYYY-MM] [--export]`
|
|
76
|
+
Monthly summary (grouped by **day** and **task**).
|
|
77
|
+
|
|
78
|
+
- If `project` is missing: pick a project
|
|
79
|
+
- If `YYYY-MM` is missing: uses current local month
|
|
80
|
+
- `--export` writes `data/<projectId>/<YYYY-MM>-info.csv`
|
|
81
|
+
|
|
82
|
+
```typescript
|
|
83
|
+
work info
|
|
84
|
+
work info Project
|
|
85
|
+
work info Project 2026-01
|
|
86
|
+
work info 2026-01
|
|
87
|
+
work info Project 2026-01 --export
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## Notes
|
|
14
91
|
|
|
15
|
-
|
|
92
|
+
- Uses **local timezone** for day/month grouping.
|
|
93
|
+
- CSV columns: `id,startAt,endAt,task,note,createdAt,updatedAt,deletedAt`
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vibecoded/work",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.3",
|
|
4
4
|
"description": "Work: CLI Time Tracker",
|
|
5
5
|
"module": "index.ts",
|
|
6
6
|
"scripts": {
|
|
@@ -25,5 +25,8 @@
|
|
|
25
25
|
"dist",
|
|
26
26
|
"README.md",
|
|
27
27
|
"LICENSE"
|
|
28
|
-
]
|
|
28
|
+
],
|
|
29
|
+
"publishConfig": {
|
|
30
|
+
"access": "public"
|
|
31
|
+
}
|
|
29
32
|
}
|