@life-os/cli 0.1.4 → 0.1.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/CHANGELOG.md +6 -0
- package/README.md +31 -13
- package/assets/icon.svg +1 -0
- package/dist/lifeos.mjs +1 -1
- package/package.json +4 -2
package/CHANGELOG.md
ADDED
package/README.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# @lifeos/cli — `lifeos`
|
|
2
2
|
|
|
3
|
+
<img src="assets/icon.svg" alt="LifeOS CLI" width="96" />
|
|
4
|
+
|
|
3
5
|
Headless, config-aware command-line interface over a LifeOS vault, built for AI
|
|
4
6
|
agents (Claude Code, etc.). Lets an agent initialize, migrate, read, query, and
|
|
5
7
|
edit a LifeOS knowledge base **without opening Obsidian or Aino**.
|
|
@@ -44,6 +46,8 @@ the onboarding target is a different directory.
|
|
|
44
46
|
```bash
|
|
45
47
|
# Read / query
|
|
46
48
|
lifeos config # effective settings + where they came from
|
|
49
|
+
lifeos today [date=YYYY-MM-DD] # source-backed AI Today view
|
|
50
|
+
lifeos board [workflow|para] # source-backed AI board view
|
|
47
51
|
lifeos tasks [todo|done|all] # list tasks (filters: tag=, keyword=, due=today|week|overdue, limit=)
|
|
48
52
|
lifeos search query=<text> # find notes (type=file default | tag | content); add `case` for content
|
|
49
53
|
lifeos read file=<name>|path=<p> # print a note
|
|
@@ -51,6 +55,7 @@ lifeos read file=<name>|path=<p> # print a note
|
|
|
51
55
|
# Onboarding any local Markdown folder (.obsidian is optional)
|
|
52
56
|
lifeos onboard inspect --json
|
|
53
57
|
lifeos onboard templates locale=en
|
|
58
|
+
lifeos onboard plan profile=memos density=full locale=en
|
|
54
59
|
lifeos onboard plan profile=para density=minimal locale=en
|
|
55
60
|
lifeos onboard apply profile=para density=minimal locale=en
|
|
56
61
|
lifeos onboard classify-input profile=para locale=en limit=30 --json
|
|
@@ -72,17 +77,23 @@ lifeos help
|
|
|
72
77
|
|
|
73
78
|
Every command accepts `--json` for machine-readable output.
|
|
74
79
|
|
|
75
|
-
Onboarding
|
|
80
|
+
Onboarding lists Memos, IPO, GTD, and PARA from easiest to hardest and supports
|
|
81
|
+
all four directly; use the separate `opc` skill
|
|
76
82
|
for OPC. Inventory recognizes `.md`, `.markdown`, and common image, video,
|
|
77
83
|
audio, PDF, document, and presentation attachments without extracting binary
|
|
78
84
|
contents. Template and classification writes are previewed first. Confirmed
|
|
79
85
|
classification batches reject paths outside the workspace, target collisions,
|
|
80
|
-
and moves that could break links.
|
|
86
|
+
and moves that could break links. For an existing conflicting file, JSON
|
|
87
|
+
onboarding plans include a `conflictEntries` item with the target content so an
|
|
88
|
+
agent can propose a field-level merge; `onboard apply` still does not overwrite
|
|
89
|
+
the file.
|
|
81
90
|
|
|
82
91
|
### Examples
|
|
83
92
|
|
|
84
93
|
```bash
|
|
85
94
|
lifeos config vault="~/Documents/My Vault"
|
|
95
|
+
lifeos today --json
|
|
96
|
+
lifeos board mode=workflow --json
|
|
86
97
|
lifeos tasks todo due=week limit=20
|
|
87
98
|
lifeos tasks done tag=个人品牌 --json
|
|
88
99
|
lifeos search query=项目 type=file
|
|
@@ -100,17 +111,24 @@ Writes take an explicit `path=` / `ref=` (no name guessing), so the agent should
|
|
|
100
111
|
Options use `key=value` (or `--key=value`); flags are bare `--flag`. This mirrors
|
|
101
112
|
the Obsidian CLI convention so agent prompting transfers.
|
|
102
113
|
|
|
103
|
-
## Agent
|
|
114
|
+
## Agent skills
|
|
104
115
|
|
|
105
|
-
The LifeOS
|
|
106
|
-
Install or update it
|
|
116
|
+
The complete LifeOS Skill bundle is embedded in the CLI from
|
|
117
|
+
`@lifeos/skill-assets`. Install or update it in the current vault after
|
|
118
|
+
upgrading `@life-os/cli`:
|
|
107
119
|
|
|
108
120
|
```bash
|
|
109
|
-
npx -y @life-os/cli skill
|
|
121
|
+
npx -y @life-os/cli@latest skill status
|
|
122
|
+
npx -y @life-os/cli@latest skill install
|
|
110
123
|
```
|
|
111
124
|
|
|
112
|
-
This
|
|
113
|
-
`.agents/skills
|
|
125
|
+
This atomically installs five independently discoverable Skills under
|
|
126
|
+
`.agents/skills/`: `lifeos`, `lifeos-today`, `lifeos-board`,
|
|
127
|
+
`lifeos-onboarding`, and `lifeos-content`. The manifest in
|
|
128
|
+
`.agents/skills/lifeos/` binds their files and fingerprints to the exact CLI
|
|
129
|
+
package version. Legacy or locally modified managed files are backed up before
|
|
130
|
+
replacement, obsolete files from the former single-Skill layout are removed,
|
|
131
|
+
and the installer refuses to downgrade a newer vault copy.
|
|
114
132
|
|
|
115
133
|
## Build & test
|
|
116
134
|
|
|
@@ -121,11 +139,11 @@ pnpm -C apps/lifeos-cli test
|
|
|
121
139
|
|
|
122
140
|
## Scope
|
|
123
141
|
|
|
124
|
-
This CLI is the **knowledge-base data layer** of LifeOS:
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
142
|
+
This CLI is the **knowledge-base data layer** of LifeOS: headless AI Today and
|
|
143
|
+
workflow/PARA board views, onboarding, migration, read/query/write of note
|
|
144
|
+
content, tasks, PARA and tags. It deliberately does not wrap background network
|
|
145
|
+
sync (Google Calendar / CalDAV / two-way task sync); those stay in the plugin
|
|
146
|
+
and Aino.
|
|
129
147
|
|
|
130
148
|
### Periodic-note resolution
|
|
131
149
|
|