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 CHANGED
@@ -1,17 +1,50 @@
1
1
  # wealthos
2
2
 
3
- Wealthos from the command line. Built for scripts and for AI agents that work
4
- through a terminal (Claude Code, Codex CLI, cron jobs).
5
-
6
- - **Your data as files.** A Wealthos vault is a folder of YAML and JSONL in the
7
- [Open Wealth Format](https://wealthos.cc/open-wealth-format/v1/README.md).
8
- Create one, validate it, and print the JSON Schema for any file type.
9
- - **Every Wealthos tool from a shell.** `call` runs the same tools the
10
- Wealthos MCP server gives Claude and ChatGPT: net worth, accounts, income,
11
- expenses, goals, plans, forecasts, the affordability check. Output is JSON.
12
- - **Country money rules, no account needed.** Sourced, dated rules for the
13
- cost of buying a home in 16 European countries, the Dutch 30% ruling and
14
- German freelancer net income.
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
- ## More
111
+ ## Links
78
112
 
79
- - [Open Wealth Format](https://wealthos.cc/open-wealth-format/v1/README.md)
80
- - [Country rules](https://wealthos.cc/country-rules/v1/index.json)
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.0");
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.0",
4
- "description": "Wealthos from the command line: your financial data as plain files (the Open Wealth Format), any Wealthos tool from a shell or script, and sourced country money rules. Works on a local vault or Wealthos Cloud.",
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/open-wealth-format/v1/README.md",
6
+ "homepage": "https://wealthos.cc",
7
7
  "repository": {
8
8
  "type": "git",
9
- "url": "git+https://github.com/vamelnyk/wealthos.git",
10
- "directory": "packages/cli"
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"