notion-vault-cli 0.1.0__tar.gz

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.
@@ -0,0 +1,223 @@
1
+ Metadata-Version: 2.4
2
+ Name: notion-vault-cli
3
+ Version: 0.1.0
4
+ Summary: Local encrypted password vault with natural-language CLI
5
+ Requires-Python: >=3.10
6
+ Description-Content-Type: text/markdown
7
+ Requires-Dist: cryptography>=48.0.0
8
+ Requires-Dist: prompt-toolkit>=3.0.52
9
+ Requires-Dist: pyperclip>=1.11.0
10
+ Requires-Dist: rich>=15.0.0
11
+
12
+ # Notion Vault CLI
13
+
14
+ Notion Vault CLI is a local, encrypted password vault you talk to in plain English.
15
+
16
+ It stores passwords, usernames, and small private notes on your machine only. There is no cloud sync, no browser extension, and no account setup. You open the vault with one master password, then ask for what you need with commands like:
17
+
18
+ ```text
19
+ save github in personal as ali
20
+ what's my github password in personal
21
+ list all
22
+ remember my uni email is ali@student.edu
23
+ ```
24
+
25
+ ## Features
26
+
27
+ - Local encrypted storage using `cryptography`
28
+ - Natural-language style CLI commands
29
+ - Folder-based organization such as `Personal`, `Education`, `Business`, or custom folders
30
+ - Multi-word folder and service names such as `borlo labs` or `notion vault`
31
+ - Password generation with clipboard auto-clear
32
+ - Search, move, delete, and quick listing commands
33
+ - Small fact memory for things like emails, IDs, or Wi-Fi labels
34
+ - Rich terminal panels and tables for a more interactive CLI experience
35
+
36
+ ## Requirements
37
+
38
+ - Python `3.14+`
39
+ - `uv`
40
+
41
+ ## Install
42
+
43
+ ```powershell
44
+ uv sync
45
+ ```
46
+
47
+ ## Run
48
+
49
+ ```powershell
50
+ uv run notion-vault
51
+ ```
52
+
53
+ This project also installs:
54
+
55
+ ```powershell
56
+ uv run notion-vault-cli
57
+ ```
58
+
59
+ ## First Run
60
+
61
+ On first launch, Notion Vault CLI will ask you to create a master password.
62
+
63
+ It stores local files in your home directory:
64
+
65
+ - `~/.notion_vault.db` for new vaults
66
+ - `~/.notion_vault.salt` for the key-derivation salt
67
+ - `~/.notion_vault.history` for prompt history
68
+
69
+ It also recognizes the older legacy files:
70
+
71
+ - `~/.pma_vault.db`
72
+ - `~/.pma_salt`
73
+ - `~/.pma_history`
74
+
75
+ If those older files already exist, the CLI will continue using them.
76
+
77
+ ## Command Guide
78
+
79
+ ### Save a login
80
+
81
+ ```text
82
+ save github in personal as ali
83
+ save notion vault in borlo labs as ali.work
84
+ add figma to client work
85
+ ```
86
+
87
+ If you leave the password blank when prompted, the CLI generates one for you.
88
+
89
+ ### Retrieve a password
90
+
91
+ ```text
92
+ what's my github password in personal
93
+ show github
94
+ get notion vault from borlo labs
95
+ ```
96
+
97
+ ### List saved entries
98
+
99
+ ```text
100
+ list all
101
+ list personal
102
+ list borlo labs
103
+ show passwords
104
+ ```
105
+
106
+ ### Search
107
+
108
+ ```text
109
+ find github
110
+ search for aws
111
+ ```
112
+
113
+ ### Move between folders
114
+
115
+ ```text
116
+ move aws from business to client work
117
+ ```
118
+
119
+ ### Delete an entry
120
+
121
+ ```text
122
+ delete github from personal
123
+ ```
124
+
125
+ ### Generate a password
126
+
127
+ ```text
128
+ generate password
129
+ generate password 24
130
+ ```
131
+
132
+ ### Copy a password to clipboard
133
+
134
+ ```text
135
+ copy github
136
+ copy my github password from personal
137
+ ```
138
+
139
+ If clipboard support is available, the copied password is cleared after 15 seconds.
140
+
141
+ ### Store and recall facts
142
+
143
+ ```text
144
+ remember my uni email is ali@student.edu
145
+ what is my uni email
146
+ recall my uni email
147
+ ```
148
+
149
+ ### Built-in utility views
150
+
151
+ ```text
152
+ help
153
+ folders
154
+ summary
155
+ quit
156
+ ```
157
+
158
+ ## Folder Behavior
159
+
160
+ Notion Vault starts with:
161
+
162
+ - `Personal`
163
+ - `Education`
164
+ - `Business`
165
+
166
+ You can create a new folder simply by saving something into it:
167
+
168
+ ```text
169
+ save figma in borlo labs as ali
170
+ ```
171
+
172
+ That creates `Borlo Labs` automatically if it does not already exist.
173
+
174
+ ## Security Notes
175
+
176
+ - Passwords are encrypted before being stored in SQLite
177
+ - The salt is stored separately in your home directory
178
+ - Everything runs locally on your machine
179
+ - Clipboard clearing is best-effort and depends on system clipboard support
180
+ - If you lose your master password, there is no recovery flow in this version
181
+
182
+ ## Project Layout
183
+
184
+ - [notion_vault_cli.py](./notion_vault_cli.py) contains the full CLI
185
+ - [pyproject.toml](./pyproject.toml) defines packaging and command entry points
186
+ - [uv.lock](./uv.lock) locks dependencies
187
+ - [Password-agent-design.html](./Password-agent-design.html) is a design/manual mockup
188
+
189
+ ## Development
190
+
191
+ Install dependencies:
192
+
193
+ ```powershell
194
+ uv sync
195
+ ```
196
+
197
+ Run the module directly:
198
+
199
+ ```powershell
200
+ uv run python notion_vault_cli.py
201
+ ```
202
+
203
+ Check syntax:
204
+
205
+ ```powershell
206
+ uv run python -m py_compile notion_vault_cli.py
207
+ ```
208
+
209
+ ## Current Scope
210
+
211
+ This is a single-file CLI application. It is intentionally simple and currently focuses on:
212
+
213
+ - local vault storage
214
+ - natural-language commands
215
+ - terminal interaction
216
+
217
+ It does not currently include:
218
+
219
+ - cloud sync
220
+ - browser autofill
221
+ - multi-user accounts
222
+ - export/import workflows
223
+ - a GUI
@@ -0,0 +1,212 @@
1
+ # Notion Vault CLI
2
+
3
+ Notion Vault CLI is a local, encrypted password vault you talk to in plain English.
4
+
5
+ It stores passwords, usernames, and small private notes on your machine only. There is no cloud sync, no browser extension, and no account setup. You open the vault with one master password, then ask for what you need with commands like:
6
+
7
+ ```text
8
+ save github in personal as ali
9
+ what's my github password in personal
10
+ list all
11
+ remember my uni email is ali@student.edu
12
+ ```
13
+
14
+ ## Features
15
+
16
+ - Local encrypted storage using `cryptography`
17
+ - Natural-language style CLI commands
18
+ - Folder-based organization such as `Personal`, `Education`, `Business`, or custom folders
19
+ - Multi-word folder and service names such as `borlo labs` or `notion vault`
20
+ - Password generation with clipboard auto-clear
21
+ - Search, move, delete, and quick listing commands
22
+ - Small fact memory for things like emails, IDs, or Wi-Fi labels
23
+ - Rich terminal panels and tables for a more interactive CLI experience
24
+
25
+ ## Requirements
26
+
27
+ - Python `3.14+`
28
+ - `uv`
29
+
30
+ ## Install
31
+
32
+ ```powershell
33
+ uv sync
34
+ ```
35
+
36
+ ## Run
37
+
38
+ ```powershell
39
+ uv run notion-vault
40
+ ```
41
+
42
+ This project also installs:
43
+
44
+ ```powershell
45
+ uv run notion-vault-cli
46
+ ```
47
+
48
+ ## First Run
49
+
50
+ On first launch, Notion Vault CLI will ask you to create a master password.
51
+
52
+ It stores local files in your home directory:
53
+
54
+ - `~/.notion_vault.db` for new vaults
55
+ - `~/.notion_vault.salt` for the key-derivation salt
56
+ - `~/.notion_vault.history` for prompt history
57
+
58
+ It also recognizes the older legacy files:
59
+
60
+ - `~/.pma_vault.db`
61
+ - `~/.pma_salt`
62
+ - `~/.pma_history`
63
+
64
+ If those older files already exist, the CLI will continue using them.
65
+
66
+ ## Command Guide
67
+
68
+ ### Save a login
69
+
70
+ ```text
71
+ save github in personal as ali
72
+ save notion vault in borlo labs as ali.work
73
+ add figma to client work
74
+ ```
75
+
76
+ If you leave the password blank when prompted, the CLI generates one for you.
77
+
78
+ ### Retrieve a password
79
+
80
+ ```text
81
+ what's my github password in personal
82
+ show github
83
+ get notion vault from borlo labs
84
+ ```
85
+
86
+ ### List saved entries
87
+
88
+ ```text
89
+ list all
90
+ list personal
91
+ list borlo labs
92
+ show passwords
93
+ ```
94
+
95
+ ### Search
96
+
97
+ ```text
98
+ find github
99
+ search for aws
100
+ ```
101
+
102
+ ### Move between folders
103
+
104
+ ```text
105
+ move aws from business to client work
106
+ ```
107
+
108
+ ### Delete an entry
109
+
110
+ ```text
111
+ delete github from personal
112
+ ```
113
+
114
+ ### Generate a password
115
+
116
+ ```text
117
+ generate password
118
+ generate password 24
119
+ ```
120
+
121
+ ### Copy a password to clipboard
122
+
123
+ ```text
124
+ copy github
125
+ copy my github password from personal
126
+ ```
127
+
128
+ If clipboard support is available, the copied password is cleared after 15 seconds.
129
+
130
+ ### Store and recall facts
131
+
132
+ ```text
133
+ remember my uni email is ali@student.edu
134
+ what is my uni email
135
+ recall my uni email
136
+ ```
137
+
138
+ ### Built-in utility views
139
+
140
+ ```text
141
+ help
142
+ folders
143
+ summary
144
+ quit
145
+ ```
146
+
147
+ ## Folder Behavior
148
+
149
+ Notion Vault starts with:
150
+
151
+ - `Personal`
152
+ - `Education`
153
+ - `Business`
154
+
155
+ You can create a new folder simply by saving something into it:
156
+
157
+ ```text
158
+ save figma in borlo labs as ali
159
+ ```
160
+
161
+ That creates `Borlo Labs` automatically if it does not already exist.
162
+
163
+ ## Security Notes
164
+
165
+ - Passwords are encrypted before being stored in SQLite
166
+ - The salt is stored separately in your home directory
167
+ - Everything runs locally on your machine
168
+ - Clipboard clearing is best-effort and depends on system clipboard support
169
+ - If you lose your master password, there is no recovery flow in this version
170
+
171
+ ## Project Layout
172
+
173
+ - [notion_vault_cli.py](./notion_vault_cli.py) contains the full CLI
174
+ - [pyproject.toml](./pyproject.toml) defines packaging and command entry points
175
+ - [uv.lock](./uv.lock) locks dependencies
176
+ - [Password-agent-design.html](./Password-agent-design.html) is a design/manual mockup
177
+
178
+ ## Development
179
+
180
+ Install dependencies:
181
+
182
+ ```powershell
183
+ uv sync
184
+ ```
185
+
186
+ Run the module directly:
187
+
188
+ ```powershell
189
+ uv run python notion_vault_cli.py
190
+ ```
191
+
192
+ Check syntax:
193
+
194
+ ```powershell
195
+ uv run python -m py_compile notion_vault_cli.py
196
+ ```
197
+
198
+ ## Current Scope
199
+
200
+ This is a single-file CLI application. It is intentionally simple and currently focuses on:
201
+
202
+ - local vault storage
203
+ - natural-language commands
204
+ - terminal interaction
205
+
206
+ It does not currently include:
207
+
208
+ - cloud sync
209
+ - browser autofill
210
+ - multi-user accounts
211
+ - export/import workflows
212
+ - a GUI
@@ -0,0 +1,223 @@
1
+ Metadata-Version: 2.4
2
+ Name: notion-vault-cli
3
+ Version: 0.1.0
4
+ Summary: Local encrypted password vault with natural-language CLI
5
+ Requires-Python: >=3.10
6
+ Description-Content-Type: text/markdown
7
+ Requires-Dist: cryptography>=48.0.0
8
+ Requires-Dist: prompt-toolkit>=3.0.52
9
+ Requires-Dist: pyperclip>=1.11.0
10
+ Requires-Dist: rich>=15.0.0
11
+
12
+ # Notion Vault CLI
13
+
14
+ Notion Vault CLI is a local, encrypted password vault you talk to in plain English.
15
+
16
+ It stores passwords, usernames, and small private notes on your machine only. There is no cloud sync, no browser extension, and no account setup. You open the vault with one master password, then ask for what you need with commands like:
17
+
18
+ ```text
19
+ save github in personal as ali
20
+ what's my github password in personal
21
+ list all
22
+ remember my uni email is ali@student.edu
23
+ ```
24
+
25
+ ## Features
26
+
27
+ - Local encrypted storage using `cryptography`
28
+ - Natural-language style CLI commands
29
+ - Folder-based organization such as `Personal`, `Education`, `Business`, or custom folders
30
+ - Multi-word folder and service names such as `borlo labs` or `notion vault`
31
+ - Password generation with clipboard auto-clear
32
+ - Search, move, delete, and quick listing commands
33
+ - Small fact memory for things like emails, IDs, or Wi-Fi labels
34
+ - Rich terminal panels and tables for a more interactive CLI experience
35
+
36
+ ## Requirements
37
+
38
+ - Python `3.14+`
39
+ - `uv`
40
+
41
+ ## Install
42
+
43
+ ```powershell
44
+ uv sync
45
+ ```
46
+
47
+ ## Run
48
+
49
+ ```powershell
50
+ uv run notion-vault
51
+ ```
52
+
53
+ This project also installs:
54
+
55
+ ```powershell
56
+ uv run notion-vault-cli
57
+ ```
58
+
59
+ ## First Run
60
+
61
+ On first launch, Notion Vault CLI will ask you to create a master password.
62
+
63
+ It stores local files in your home directory:
64
+
65
+ - `~/.notion_vault.db` for new vaults
66
+ - `~/.notion_vault.salt` for the key-derivation salt
67
+ - `~/.notion_vault.history` for prompt history
68
+
69
+ It also recognizes the older legacy files:
70
+
71
+ - `~/.pma_vault.db`
72
+ - `~/.pma_salt`
73
+ - `~/.pma_history`
74
+
75
+ If those older files already exist, the CLI will continue using them.
76
+
77
+ ## Command Guide
78
+
79
+ ### Save a login
80
+
81
+ ```text
82
+ save github in personal as ali
83
+ save notion vault in borlo labs as ali.work
84
+ add figma to client work
85
+ ```
86
+
87
+ If you leave the password blank when prompted, the CLI generates one for you.
88
+
89
+ ### Retrieve a password
90
+
91
+ ```text
92
+ what's my github password in personal
93
+ show github
94
+ get notion vault from borlo labs
95
+ ```
96
+
97
+ ### List saved entries
98
+
99
+ ```text
100
+ list all
101
+ list personal
102
+ list borlo labs
103
+ show passwords
104
+ ```
105
+
106
+ ### Search
107
+
108
+ ```text
109
+ find github
110
+ search for aws
111
+ ```
112
+
113
+ ### Move between folders
114
+
115
+ ```text
116
+ move aws from business to client work
117
+ ```
118
+
119
+ ### Delete an entry
120
+
121
+ ```text
122
+ delete github from personal
123
+ ```
124
+
125
+ ### Generate a password
126
+
127
+ ```text
128
+ generate password
129
+ generate password 24
130
+ ```
131
+
132
+ ### Copy a password to clipboard
133
+
134
+ ```text
135
+ copy github
136
+ copy my github password from personal
137
+ ```
138
+
139
+ If clipboard support is available, the copied password is cleared after 15 seconds.
140
+
141
+ ### Store and recall facts
142
+
143
+ ```text
144
+ remember my uni email is ali@student.edu
145
+ what is my uni email
146
+ recall my uni email
147
+ ```
148
+
149
+ ### Built-in utility views
150
+
151
+ ```text
152
+ help
153
+ folders
154
+ summary
155
+ quit
156
+ ```
157
+
158
+ ## Folder Behavior
159
+
160
+ Notion Vault starts with:
161
+
162
+ - `Personal`
163
+ - `Education`
164
+ - `Business`
165
+
166
+ You can create a new folder simply by saving something into it:
167
+
168
+ ```text
169
+ save figma in borlo labs as ali
170
+ ```
171
+
172
+ That creates `Borlo Labs` automatically if it does not already exist.
173
+
174
+ ## Security Notes
175
+
176
+ - Passwords are encrypted before being stored in SQLite
177
+ - The salt is stored separately in your home directory
178
+ - Everything runs locally on your machine
179
+ - Clipboard clearing is best-effort and depends on system clipboard support
180
+ - If you lose your master password, there is no recovery flow in this version
181
+
182
+ ## Project Layout
183
+
184
+ - [notion_vault_cli.py](./notion_vault_cli.py) contains the full CLI
185
+ - [pyproject.toml](./pyproject.toml) defines packaging and command entry points
186
+ - [uv.lock](./uv.lock) locks dependencies
187
+ - [Password-agent-design.html](./Password-agent-design.html) is a design/manual mockup
188
+
189
+ ## Development
190
+
191
+ Install dependencies:
192
+
193
+ ```powershell
194
+ uv sync
195
+ ```
196
+
197
+ Run the module directly:
198
+
199
+ ```powershell
200
+ uv run python notion_vault_cli.py
201
+ ```
202
+
203
+ Check syntax:
204
+
205
+ ```powershell
206
+ uv run python -m py_compile notion_vault_cli.py
207
+ ```
208
+
209
+ ## Current Scope
210
+
211
+ This is a single-file CLI application. It is intentionally simple and currently focuses on:
212
+
213
+ - local vault storage
214
+ - natural-language commands
215
+ - terminal interaction
216
+
217
+ It does not currently include:
218
+
219
+ - cloud sync
220
+ - browser autofill
221
+ - multi-user accounts
222
+ - export/import workflows
223
+ - a GUI
@@ -0,0 +1,10 @@
1
+ README.md
2
+ notion_vault_cli.py
3
+ pyproject.toml
4
+ notion_vault_cli.egg-info/PKG-INFO
5
+ notion_vault_cli.egg-info/SOURCES.txt
6
+ notion_vault_cli.egg-info/dependency_links.txt
7
+ notion_vault_cli.egg-info/entry_points.txt
8
+ notion_vault_cli.egg-info/requires.txt
9
+ notion_vault_cli.egg-info/top_level.txt
10
+ tests/test_notion_vault_cli.py
@@ -0,0 +1,3 @@
1
+ [console_scripts]
2
+ notion-vault = notion_vault_cli:main
3
+ notion-vault-cli = notion_vault_cli:main
@@ -0,0 +1,4 @@
1
+ cryptography>=48.0.0
2
+ prompt-toolkit>=3.0.52
3
+ pyperclip>=1.11.0
4
+ rich>=15.0.0
@@ -0,0 +1 @@
1
+ notion_vault_cli