itsvertical 0.0.4 → 0.0.6

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 CHANGED
@@ -51,6 +51,7 @@ All entities are addressed by ID. Use `itsvertical show` to see IDs. Every comma
51
51
  ### Project
52
52
 
53
53
  ```
54
+ itsvertical <file> # Shorthand for "open"
54
55
  itsvertical new <path> <name> # Create a new .vertical file
55
56
  itsvertical open <file> # Open in the browser UI
56
57
  itsvertical show <file> # Print the board to the terminal
@@ -70,6 +71,9 @@ itsvertical task undone <file> <task-id> # Mark a task as not done
70
71
  itsvertical task rename <file> <task-id> <name> # Rename a task
71
72
  itsvertical task delete <file> <task-id> # Delete a task
72
73
  itsvertical task move <file> <task-id> <layer> # Move a task to another layer
74
+ itsvertical task notes <file> <task-id> # Print task notes
75
+ itsvertical task notes <file> <tid> --set <html> # Set notes (HTML)
76
+ itsvertical task notes <file> <task-id> --clear # Clear notes
73
77
  ```
74
78
 
75
79
  ### Boxes
@@ -93,7 +97,7 @@ itsvertical layer status <file> <layer-id> none # Clear status
93
97
 
94
98
  ### Browser UI
95
99
 
96
- `itsvertical open` starts a local server and opens the board in your browser. Click **Save** or press **Ctrl+S** / **Cmd+S** to write changes back to the file.
100
+ `itsvertical open` (or just `itsvertical <file>`) starts a local server and opens the board in your browser. Changes are saved automatically.
97
101
 
98
102
  ## The board
99
103
 
@@ -118,7 +122,6 @@ Each box represents a vertical slice of work.
118
122
  | **Delete** / **Backspace** | Delete focused task or unsplit focused layer |
119
123
  | **Enter** | Save inline edit |
120
124
  | **Shift+Enter** | Save edit and create a new task below |
121
- | **Ctrl/Cmd+S** | Save to file |
122
125
 
123
126
  ## The `.vertical` file
124
127
 
@@ -160,6 +163,18 @@ pnpm run build # builds both SPA (vite) and CLI (tsup)
160
163
  pnpm run build:cli # builds only the CLI
161
164
  ```
162
165
 
166
+ ### Dev
167
+
168
+ ```
169
+ pnpm run dev
170
+ ```
171
+
172
+ Starts a full dev environment with Vite HMR for the SPA and auto-restart for the CLI server. Creates a `dev.vertical` file from `sample.vertical` on first run (preserved across restarts). The browser opens automatically.
173
+
174
+ - **SPA:** Vite dev server at `http://localhost:4007` with HMR
175
+ - **CLI server:** Rebuilds and restarts automatically on changes (port 3456)
176
+ - **API proxy:** Vite proxies `/api/*` to the CLI server
177
+
163
178
  ### Test locally
164
179
 
165
180
  ```
@@ -168,6 +183,14 @@ pnpm run itsvertical -- new test-project.vertical "Test Project"
168
183
  pnpm run itsvertical -- open test-project.vertical
169
184
  ```
170
185
 
186
+ ### Test
187
+
188
+ ```
189
+ pnpm run test
190
+ ```
191
+
192
+ Unit tests use [Vitest](https://vitest.dev). Tests are co-located with source files (`*.test.ts`).
193
+
171
194
  ### Lint and type-check
172
195
 
173
196
  ```
@@ -177,12 +200,7 @@ pnpm run lint
177
200
 
178
201
  ### Publish
179
202
 
180
- ```
181
- pnpm run build
182
- npm publish
183
- ```
184
-
185
- The `files` field in `package.json` includes only `cli/dist` and `dist` — the built outputs. Source files are not published.
203
+ Use the `/release` skill in Claude Code to publish a new version. It bumps the version, builds, and creates a GitHub release. You only need to run `npm publish` yourself (for OTP).
186
204
 
187
205
  ## Credits
188
206