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.
- notion_vault_cli-0.1.0/PKG-INFO +223 -0
- notion_vault_cli-0.1.0/README.md +212 -0
- notion_vault_cli-0.1.0/notion_vault_cli.egg-info/PKG-INFO +223 -0
- notion_vault_cli-0.1.0/notion_vault_cli.egg-info/SOURCES.txt +10 -0
- notion_vault_cli-0.1.0/notion_vault_cli.egg-info/dependency_links.txt +1 -0
- notion_vault_cli-0.1.0/notion_vault_cli.egg-info/entry_points.txt +3 -0
- notion_vault_cli-0.1.0/notion_vault_cli.egg-info/requires.txt +4 -0
- notion_vault_cli-0.1.0/notion_vault_cli.egg-info/top_level.txt +1 -0
- notion_vault_cli-0.1.0/notion_vault_cli.py +770 -0
- notion_vault_cli-0.1.0/pyproject.toml +19 -0
- notion_vault_cli-0.1.0/setup.cfg +4 -0
- notion_vault_cli-0.1.0/tests/test_notion_vault_cli.py +141 -0
|
@@ -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 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
notion_vault_cli
|