@life-os/cli 0.1.3 → 0.1.4

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
@@ -1,8 +1,8 @@
1
1
  # @lifeos/cli — `lifeos`
2
2
 
3
3
  Headless, config-aware command-line interface over a LifeOS vault, built for AI
4
- agents (Claude Code, etc.). Lets an agent read and query your LifeOS notes,
5
- tasks, PARA and tags **without opening Obsidian or Aino**.
4
+ agents (Claude Code, etc.). Lets an agent initialize, migrate, read, query, and
5
+ edit a LifeOS knowledge base **without opening Obsidian or Aino**.
6
6
 
7
7
  ## Why it exists
8
8
 
@@ -27,13 +27,18 @@ to see exactly what was picked up.
27
27
 
28
28
  1. `vault=<path>` option
29
29
  2. `$LIFEOS_VAULT` env var
30
- 3. Walk up from the current directory for a `.obsidian/` or `.lifeos/` folder
30
+ 3. Walk up from the current directory for `.obsidian/`, `.lifeos/`, or
31
+ `.agents/skills/lifeos/`
31
32
  4. The folder Aino last opened (`userData/bootstrap.json` → `lastOpenedFolder`)
32
33
 
33
34
  The cwd walk comes before the Aino fallback by design: when an agent works inside
34
35
  a vault, the cwd is the most reliable signal of which vault the user means.
35
36
  Aino's last-opened folder is only used when running outside any vault.
36
37
 
38
+ `onboard` intentionally uses an empty current directory instead of that Aino
39
+ fallback, so a new local folder is safe to initialize. Pass `vault=<path>` when
40
+ the onboarding target is a different directory.
41
+
37
42
  ## Commands
38
43
 
39
44
  ```bash
@@ -43,6 +48,15 @@ lifeos tasks [todo|done|all] # list tasks (filters: tag=, keyword=, due=t
43
48
  lifeos search query=<text> # find notes (type=file default | tag | content); add `case` for content
44
49
  lifeos read file=<name>|path=<p> # print a note
45
50
 
51
+ # Onboarding any local Markdown folder (.obsidian is optional)
52
+ lifeos onboard inspect --json
53
+ lifeos onboard templates locale=en
54
+ lifeos onboard plan profile=para density=minimal locale=en
55
+ lifeos onboard apply profile=para density=minimal locale=en
56
+ lifeos onboard classify-input profile=para locale=en limit=30 --json
57
+ lifeos onboard classify-plan file=.lifeos/classification-plans/batch.json --json
58
+ lifeos onboard classify-apply file=.lifeos/classification-plans/batch.json --json
59
+
46
60
  # Periodic notes — daily|weekly|monthly|quarterly|yearly (path from periodicNotesPath + format)
47
61
  lifeos daily [date=YYYY-MM-DD] # show the note path + whether it exists
48
62
  lifeos weekly:read [date=] # read the note
@@ -58,6 +72,13 @@ lifeos help
58
72
 
59
73
  Every command accepts `--json` for machine-readable output.
60
74
 
75
+ Onboarding supports PARA, IPO, and GTD directly; use the separate `opc` skill
76
+ for OPC. Inventory recognizes `.md`, `.markdown`, and common image, video,
77
+ audio, PDF, document, and presentation attachments without extracting binary
78
+ contents. Template and classification writes are previewed first. Confirmed
79
+ classification batches reject paths outside the workspace, target collisions,
80
+ and moves that could break links.
81
+
61
82
  ### Examples
62
83
 
63
84
  ```bash
@@ -100,8 +121,9 @@ pnpm -C apps/lifeos-cli test
100
121
 
101
122
  ## Scope
102
123
 
103
- This CLI is the **vault data layer** of LifeOS: read/query/(soon) write of note
104
- content, tasks, PARA and tags. It deliberately does **not** wrap the plugin's UI
124
+ This CLI is the **knowledge-base data layer** of LifeOS: onboarding, migration,
125
+ read/query/write of note content, tasks, PARA and tags. It deliberately does
126
+ **not** wrap the plugin's UI
105
127
  views or background network sync (Google Calendar / CalDAV / two-way task sync) —
106
128
  those stay in the plugin and Aino.
107
129