You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+27-15Lines changed: 27 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -57,10 +57,19 @@ aw-nextblock provides structure without rigidity. Plans are guides, not rules. Y
57
57
Use `aw-nextblock` for session management:
58
58
59
59
```bash
60
-
aw-nextblock start <plan.yaml># Start a work session
61
-
aw-nextblock next # Move to next block
62
-
aw-nextblock status # Check current status
63
-
aw-nextblock stop # Stop current session
60
+
aw-nextblock # Start the watcher process
61
+
aw-nextblock start <plan.yaml># Start a work session
62
+
aw-nextblock next # Move to next block
63
+
aw-nextblock status # Check current status
64
+
aw-nextblock stop # Stop current session
65
+
aw-nextblock --help # Show help
66
+
aw-nextblock --version # Show version
67
+
```
68
+
69
+
**Watcher-specific flags:**
70
+
```bash
71
+
aw-nextblock --testing # Start watcher in testing mode
72
+
aw-nextblock --verbose # Enable verbose logging
64
73
```
65
74
66
75
### Triggering Next
@@ -101,7 +110,7 @@ Durations are estimates, not limits.
101
110
aw-nextblock start plan.yaml
102
111
```
103
112
104
-
This creates a session file and start its aw watcher process.
113
+
This creates a session.json file. The watcher process monitors this file.
105
114
106
115
#### 3. Work and Advance
107
116
@@ -144,6 +153,17 @@ After completing your work session, use the custom visualization in ActivityWatc
144
153
-**Linux/macOS**: Copy to `/usr/local/bin/` or add to your `$PATH`
145
154
-**Windows**: Add to a directory in your `PATH` environment variable
146
155
156
+
### Autostart Watcher
157
+
158
+
Optionally, add `aw-nextblock` to autostart in your `aw-qt.toml` file in the [config directory](https://docs.activitywatch.net/en/latest/directories.html#config).
159
+
160
+
Add `aw-nextblock` to the `autostart_modules` list:
The visualization allows you to see your planned vs actual activity data in ActivityWatch's web UI. This is an **experimental feature** that requires manual configuration.
The watcher (started with `aw-nextblock start`) can be configured by creating a `aw-watcher-nextblock.toml` file in the watcher's configuration directory:
199
+
Create a `aw-watcher-nextblock.toml` file in the watcher's configuration directory:
0 commit comments