wealthos 0.0.0-stage → 0.1.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/LICENSE +21 -0
- package/README.md +84 -2
- package/dist/wealthos.cjs +51212 -0
- package/package.json +36 -3
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Volodymyr Melnyk
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,85 @@
|
|
|
1
|
-
#
|
|
1
|
+
# wealthos
|
|
2
2
|
|
|
3
|
-
|
|
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.
|
|
15
|
+
|
|
16
|
+
Needs Node 20 or later.
|
|
17
|
+
|
|
18
|
+
```sh
|
|
19
|
+
npx wealthos --help
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## A local vault
|
|
23
|
+
|
|
24
|
+
```sh
|
|
25
|
+
npx wealthos init ~/Documents/Wealthos --currency EUR
|
|
26
|
+
npx wealthos call ~/Documents/Wealthos accounts_add name=Current type=bank balance=8200
|
|
27
|
+
npx wealthos call ~/Documents/Wealthos wealth_get
|
|
28
|
+
npx wealthos call ~/Documents/Wealthos affordability_check amount=1200 what="flight to Lisbon" --text
|
|
29
|
+
npx wealthos doctor ~/Documents/Wealthos
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
If the Wealthos desktop app has the vault open, commands go through the app
|
|
33
|
+
instead of opening the folder a second time.
|
|
34
|
+
|
|
35
|
+
## Wealthos Cloud
|
|
36
|
+
|
|
37
|
+
Pass the MCP server URL instead of a folder, with an API token from
|
|
38
|
+
**Settings → Connect to AI tools via MCP**:
|
|
39
|
+
|
|
40
|
+
```sh
|
|
41
|
+
export WEALTHOS_TOKEN=wos_...
|
|
42
|
+
npx wealthos tools https://mcp.wealthos.cc --text
|
|
43
|
+
npx wealthos call https://mcp.wealthos.cc goals_list
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## Country rules
|
|
47
|
+
|
|
48
|
+
```sh
|
|
49
|
+
npx wealthos rules # every rule, with review status
|
|
50
|
+
npx wealthos rules se.property_purchase_costs price=4500000 --text
|
|
51
|
+
npx wealthos rules de.property_purchase_costs price=500000 region=berlin non_resident=true
|
|
52
|
+
npx wealthos rules nl.expat_tax_regime gross_annual_salary=70000
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Planning estimates, not tax or legal advice. Each rule lists its sources and
|
|
56
|
+
when it was last checked.
|
|
57
|
+
|
|
58
|
+
## Commands
|
|
59
|
+
|
|
60
|
+
| Command | |
|
|
61
|
+
|---|---|
|
|
62
|
+
| `tools <target> [--text] [--schemas]` | List tools (JSON, or one line each) |
|
|
63
|
+
| `call <target> <tool> [--args JSON] [key=value …] [--text]` | Call a tool. `key=value` values are read as JSON when they parse; dotted keys nest (`date.year=2027`) |
|
|
64
|
+
| `schema [name]` | Open Wealth Format file types, or one JSON Schema |
|
|
65
|
+
| `rules [id] [key=value …] [--country X] [--topic T] [--due] [--text]` | List, show or calculate a country rule |
|
|
66
|
+
| `init <dir> [--email E] [--currency EUR]` | Create a vault |
|
|
67
|
+
| `doctor <dir> [--clear-stale-lock]` | Validate every file in a vault; changes nothing |
|
|
68
|
+
| `mcp-stdio <dir>` | Serve a vault to an MCP client over stdio |
|
|
69
|
+
| `serve <dir>` | The local core the desktop app runs |
|
|
70
|
+
|
|
71
|
+
`<target>` is a vault folder, or an `https://` MCP server URL with `--token` or
|
|
72
|
+
`$WEALTHOS_TOKEN`.
|
|
73
|
+
|
|
74
|
+
Exit codes: `0` success, `1` the tool reported a failure (its JSON is still
|
|
75
|
+
printed), `2` bad usage or an unknown tool.
|
|
76
|
+
|
|
77
|
+
## More
|
|
78
|
+
|
|
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)
|
|
82
|
+
|
|
83
|
+
## License
|
|
84
|
+
|
|
85
|
+
MIT
|