wealthos 0.1.0 → 0.1.1
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 +54 -17
- package/dist/wealthos.cjs +1 -1
- package/package.json +12 -6
package/README.md
CHANGED
|
@@ -1,17 +1,50 @@
|
|
|
1
1
|
# wealthos
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
-
|
|
13
|
-
|
|
14
|
-
|
|
3
|
+
The command-line tool for **[Wealthos](https://wealthos.cc)**, a personal
|
|
4
|
+
wealth planning and forecasting app.
|
|
5
|
+
|
|
6
|
+
## What is Wealthos?
|
|
7
|
+
|
|
8
|
+
Wealthos helps you simulate life's big decisions before you make them (a
|
|
9
|
+
house, a move, a career change, a sabbatical) and see where each one leaves
|
|
10
|
+
you years out. It's built on your real balances across every bank and
|
|
11
|
+
currency you hold: net worth, income and expenses, savings goals, dated plans
|
|
12
|
+
and long-range forecasts.
|
|
13
|
+
|
|
14
|
+
It comes in two editions:
|
|
15
|
+
|
|
16
|
+
- **[Wealthos Cloud](https://wealthos.cc)**: web app and iOS app, with bank
|
|
17
|
+
connections and sync across devices.
|
|
18
|
+
- **[Wealthos Local](https://wealthos.cc/local)**: a macOS app that keeps
|
|
19
|
+
everything as plain files in a folder you choose. No account, works
|
|
20
|
+
offline.
|
|
21
|
+
|
|
22
|
+
Both expose your finances to AI assistants (Claude, ChatGPT, Cursor, Codex)
|
|
23
|
+
through the [Wealthos MCP server](https://wealthos.cc/mcp).
|
|
24
|
+
|
|
25
|
+
## What this package is for
|
|
26
|
+
|
|
27
|
+
`wealthos` brings the same tools to a terminal, for scripts and for AI agents
|
|
28
|
+
that work through a shell (Claude Code, Codex CLI, cron jobs). Output is JSON.
|
|
29
|
+
|
|
30
|
+
- **Let an agent manage your finances.** Ask Claude Code "how much can I put
|
|
31
|
+
aside each month for a house in 2028?" and it can read your accounts, goals
|
|
32
|
+
and plans and run the forecast itself, instead of guessing at the
|
|
33
|
+
arithmetic.
|
|
34
|
+
- **Check a purchase before you make it.** `affordability_check` returns a
|
|
35
|
+
verdict plus the trade-offs: a goal pushed back, investments to sell, a
|
|
36
|
+
safety buffer breached.
|
|
37
|
+
- **Keep your finances as plain files.** A vault is a folder of YAML and
|
|
38
|
+
JSONL in the documented
|
|
39
|
+
[Open Wealth Format](https://wealthos.cc/open-wealth-format/v1/README.md),
|
|
40
|
+
so it works with `git`, backups and any editor. Create one, validate it,
|
|
41
|
+
and print the JSON Schema for any file type. The Wealthos desktop app opens
|
|
42
|
+
the same folder.
|
|
43
|
+
- **Automate.** Log net worth from a cron job (`wealth_get`), add income
|
|
44
|
+
and expenses from a script, pipe any result into `jq`.
|
|
45
|
+
- **Look up country money rules, no account needed.** Sourced, dated rules
|
|
46
|
+
for the cost of buying a home in 16 European countries, the Dutch 30%
|
|
47
|
+
ruling and German freelancer net income.
|
|
15
48
|
|
|
16
49
|
Needs Node 20 or later.
|
|
17
50
|
|
|
@@ -35,7 +68,8 @@ instead of opening the folder a second time.
|
|
|
35
68
|
## Wealthos Cloud
|
|
36
69
|
|
|
37
70
|
Pass the MCP server URL instead of a folder, with an API token from
|
|
38
|
-
**Settings → Connect to AI tools via MCP
|
|
71
|
+
**Settings → Connect to AI tools via MCP** in the
|
|
72
|
+
[Wealthos web app](https://wealthos.cc):
|
|
39
73
|
|
|
40
74
|
```sh
|
|
41
75
|
export WEALTHOS_TOKEN=wos_...
|
|
@@ -74,11 +108,14 @@ when it was last checked.
|
|
|
74
108
|
Exit codes: `0` success, `1` the tool reported a failure (its JSON is still
|
|
75
109
|
printed), `2` bad usage or an unknown tool.
|
|
76
110
|
|
|
77
|
-
##
|
|
111
|
+
## Links
|
|
78
112
|
|
|
79
|
-
- [
|
|
80
|
-
- [
|
|
81
|
-
- [Wealthos MCP server](https://wealthos.cc/mcp)
|
|
113
|
+
- [Wealthos](https://wealthos.cc): the app
|
|
114
|
+
- [Wealthos Local](https://wealthos.cc/local): the macOS app for plain-file vaults
|
|
115
|
+
- [Wealthos MCP server](https://wealthos.cc/mcp): connect Claude, ChatGPT and other assistants
|
|
116
|
+
- [Open Wealth Format](https://wealthos.cc/open-wealth-format/v1/README.md): the vault file format
|
|
117
|
+
- [Country rules](https://wealthos.cc/country-rules/v1/index.json): the rules library as JSON
|
|
118
|
+
- [Issues](https://github.com/vamelnyk/wealthos-app/issues): report a problem or ask a question
|
|
82
119
|
|
|
83
120
|
## License
|
|
84
121
|
|
package/dist/wealthos.cjs
CHANGED
|
@@ -51032,7 +51032,7 @@ async function main() {
|
|
|
51032
51032
|
return;
|
|
51033
51033
|
}
|
|
51034
51034
|
if (command === "--version" || command === "-v" || command === "version") {
|
|
51035
|
-
console.log("0.1.
|
|
51035
|
+
console.log("0.1.1");
|
|
51036
51036
|
return;
|
|
51037
51037
|
}
|
|
51038
51038
|
if (command === "schema") {
|
package/package.json
CHANGED
|
@@ -1,21 +1,27 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "wealthos",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "Command-line tool for Wealthos (https://wealthos.cc), personal wealth planning and forecasting: run any Wealthos tool from a shell or an AI agent, keep your finances as plain files in the Open Wealth Format, and look up sourced country money rules. Works on a local vault or Wealthos Cloud.",
|
|
5
5
|
"license": "MIT",
|
|
6
|
-
"homepage": "https://wealthos.cc
|
|
6
|
+
"homepage": "https://wealthos.cc",
|
|
7
7
|
"repository": {
|
|
8
8
|
"type": "git",
|
|
9
|
-
"url": "git+https://github.com/vamelnyk/wealthos.git"
|
|
10
|
-
|
|
9
|
+
"url": "git+https://github.com/vamelnyk/wealthos-app.git"
|
|
10
|
+
},
|
|
11
|
+
"bugs": {
|
|
12
|
+
"url": "https://github.com/vamelnyk/wealthos-app/issues"
|
|
11
13
|
},
|
|
12
14
|
"keywords": [
|
|
15
|
+
"wealthos",
|
|
13
16
|
"personal-finance",
|
|
14
17
|
"net-worth",
|
|
15
18
|
"mcp",
|
|
16
19
|
"ai-agents",
|
|
17
20
|
"cli",
|
|
18
|
-
"open-wealth-format"
|
|
21
|
+
"open-wealth-format",
|
|
22
|
+
"forecasting",
|
|
23
|
+
"budgeting",
|
|
24
|
+
"claude-code"
|
|
19
25
|
],
|
|
20
26
|
"bin": {
|
|
21
27
|
"wealthos": "dist/wealthos.cjs"
|