@contextium/cli 1.7.1 → 1.8.0

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
@@ -131,28 +131,17 @@ contextium find "api" -w <workspace> # Find files by name/co
131
131
 
132
132
  ### Tags
133
133
 
134
- ```bash
135
- # Tag types (categories)
136
- contextium tags types -w <workspace>
137
- contextium tags create-type -w <workspace> -n "Topic"
138
- contextium tags type-get -w <workspace> --type <typeId>
139
- contextium tags type-update -w <workspace> --type <typeId> --name "Topic"
134
+ Tags are flat and untyped — a tag is just a `#value` (no categories, no `type:value` format). A file is tagged by typing `#value` inside its content; the tag is reconciled when the file is saved.
140
135
 
141
- # Tags
136
+ ```bash
137
+ # Read-only — tags are content-driven, so there are no create/update/delete commands
142
138
  contextium tags list -w <workspace>
143
- contextium tags create -w <workspace> --type <typeId> --value authentication
144
- contextium tags update -w <workspace> --tag <tagId> --value auth
145
-
146
- # Apply / remove
147
- contextium tags apply -w <workspace> --tag topic:authentication --file <fileId>
148
- contextium tags apply-bulk -w <workspace> --tag <tagId> --files <file1,file2>
149
- contextium tags remove -w <workspace> --tag <tagId> --file <fileId>
150
-
151
- # Search by tags
152
- contextium tags search -w <workspace> --tags topic:authentication
139
+ contextium tags search -w <workspace> --tags authentication
153
140
  contextium tags file-tags -w <workspace> --file <fileId>
154
141
  ```
155
142
 
143
+ To tag a file, author the tag inline — add a `#authentication` token to the file's content (e.g. `contextium edit-file <id> --content "… #authentication"`); the tag is created on save. To untag, remove the token. There are no `tags create`, `tags update`, or `tags delete` commands, and `tags apply`/`apply-bulk`/`remove` are deprecated — tagging is entirely inline.
144
+
156
145
  ### Agents and Skills
157
146
 
158
147
  ```bash
@@ -230,18 +219,12 @@ contextium workflow "Onboarding" -w acme-corp
230
219
  ### Organise docs with tags
231
220
 
232
221
  ```bash
233
- # Create a tag type
234
- contextium tags create-type -w my-workspace -n "Topic" --slug topic
235
-
236
- # Create tags
237
- contextium tags create -w my-workspace --type <typeId> --value authentication
238
- contextium tags create -w my-workspace --type <typeId> --value deployment
239
-
240
- # Tag files
241
- contextium tags apply -w my-workspace --tag topic:authentication --file <fileId>
222
+ # Tag a file by adding #authentication inside its content, then save —
223
+ # the tag is created and reconciled from the file content automatically.
224
+ contextium edit-file <fileId> --content "… #authentication"
242
225
 
243
226
  # Find all authentication files
244
- contextium tags search -w my-workspace --tags topic:authentication
227
+ contextium tags search -w my-workspace --tags authentication
245
228
  ```
246
229
 
247
230
  ## Links