nexvault 0.1.0__tar.gz

nexvault-0.1.0/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

nexvault-0.1.0/PKG-INFO

@@ -0,0 +1,395 @@
+Metadata-Version: 2.3
+Name: nexvault
+Version: 0.1.0
+Summary: Nexvault is a simple, secure, and developer-friendly vault for managing your sensitive secrets locally.
+Author: Nexment
+License: 
+                                          Apache License
+                                    Version 2.0, January 2004
+                                 http://www.apache.org/licenses/
+         
+            TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+         
+            1. Definitions.
+         
+               "License" shall mean the terms and conditions for use, reproduction,
+               and distribution as defined by Sections 1 through 9 of this document.
+         
+               "Licensor" shall mean the copyright owner or entity authorized by
+               the copyright owner that is granting the License.
+         
+               "Legal Entity" shall mean the union of the acting entity and all
+               other entities that control, are controlled by, or are under common
+               control with that entity. For the purposes of this definition,
+               "control" means (i) the power, direct or indirect, to cause the
+               direction or management of such entity, whether by contract or
+               otherwise, or (ii) ownership of fifty percent (50%) or more of the
+               outstanding shares, or (iii) beneficial ownership of such entity.
+         
+               "You" (or "Your") shall mean an individual or Legal Entity
+               exercising permissions granted by this License.
+         
+               "Source" form shall mean the preferred form for making modifications,
+               including but not limited to software source code, documentation
+               source, and configuration files.
+         
+               "Object" form shall mean any form resulting from mechanical
+               transformation or translation of a Source form, including but
+               not limited to compiled object code, generated documentation,
+               and conversions to other media types.
+         
+               "Work" shall mean the work of authorship, whether in Source or
+               Object form, made available under the License, as indicated by a
+               copyright notice that is included in or attached to the work
+               (an example is provided in the Appendix below).
+         
+               "Derivative Works" shall mean any work, whether in Source or Object
+               form, that is based on (or derived from) the Work and for which the
+               editorial revisions, annotations, elaborations, or other modifications
+               represent, as a whole, an original work of authorship. For the purposes
+               of this License, Derivative Works shall not include works that remain
+               separable from, or merely link (or bind by name) to the interfaces of,
+               the Work and Derivative Works thereof.
+         
+               "Contribution" shall mean any work of authorship, including
+               the original version of the Work and any modifications or additions
+               to that Work or Derivative Works thereof, that is intentionally
+               submitted to Licensor for inclusion in the Work by the copyright owner
+               or by an individual or Legal Entity authorized to submit on behalf of
+               the copyright owner. For the purposes of this definition, "submitted"
+               means any form of electronic, verbal, or written communication sent
+               to the Licensor or its representatives, including but not limited to
+               communication on electronic mailing lists, source code control systems,
+               and issue tracking systems that are managed by, or on behalf of, the
+               Licensor for the purpose of discussing and improving the Work, but
+               excluding communication that is conspicuously marked or otherwise
+               designated in writing by the copyright owner as "Not a Contribution."
+         
+               "Contributor" shall mean Licensor and any individual or Legal Entity
+               on behalf of whom a Contribution has been received by Licensor and
+               subsequently incorporated within the Work.
+         
+            2. Grant of Copyright License. Subject to the terms and conditions of
+               this License, each Contributor hereby grants to You a perpetual,
+               worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+               copyright license to reproduce, prepare Derivative Works of,
+               publicly display, publicly perform, sublicense, and distribute the
+               Work and such Derivative Works in Source or Object form.
+         
+            3. Grant of Patent License. Subject to the terms and conditions of
+               this License, each Contributor hereby grants to You a perpetual,
+               worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+               (except as stated in this section) patent license to make, have made,
+               use, offer to sell, sell, import, and otherwise transfer the Work,
+               where such license applies only to those patent claims licensable
+               by such Contributor that are necessarily infringed by their
+               Contribution(s) alone or by combination of their Contribution(s)
+               with the Work to which such Contribution(s) was submitted. If You
+               institute patent litigation against any entity (including a
+               cross-claim or counterclaim in a lawsuit) alleging that the Work
+               or a Contribution incorporated within the Work constitutes direct
+               or contributory patent infringement, then any patent licenses
+               granted to You under this License for that Work shall terminate
+               as of the date such litigation is filed.
+         
+            4. Redistribution. You may reproduce and distribute copies of the
+               Work or Derivative Works thereof in any medium, with or without
+               modifications, and in Source or Object form, provided that You
+               meet the following conditions:
+         
+               (a) You must give any other recipients of the Work or
+                   Derivative Works a copy of this License; and
+         
+               (b) You must cause any modified files to carry prominent notices
+                   stating that You changed the files; and
+         
+               (c) You must retain, in the Source form of any Derivative Works
+                   that You distribute, all copyright, patent, trademark, and
+                   attribution notices from the Source form of the Work,
+                   excluding those notices that do not pertain to any part of
+                   the Derivative Works; and
+         
+               (d) If the Work includes a "NOTICE" text file as part of its
+                   distribution, then any Derivative Works that You distribute must
+                   include a readable copy of the attribution notices contained
+                   within such NOTICE file, excluding those notices that do not
+                   pertain to any part of the Derivative Works, in at least one
+                   of the following places: within a NOTICE text file distributed
+                   as part of the Derivative Works; within the Source form or
+                   documentation, if provided along with the Derivative Works; or,
+                   within a display generated by the Derivative Works, if and
+                   wherever such third-party notices normally appear. The contents
+                   of the NOTICE file are for informational purposes only and
+                   do not modify the License. You may add Your own attribution
+                   notices within Derivative Works that You distribute, alongside
+                   or as an addendum to the NOTICE text from the Work, provided
+                   that such additional attribution notices cannot be construed
+                   as modifying the License.
+         
+               You may add Your own copyright statement to Your modifications and
+               may provide additional or different license terms and conditions
+               for use, reproduction, or distribution of Your modifications, or
+               for any such Derivative Works as a whole, provided Your use,
+               reproduction, and distribution of the Work otherwise complies with
+               the conditions stated in this License.
+         
+            5. Submission of Contributions. Unless You explicitly state otherwise,
+               any Contribution intentionally submitted for inclusion in the Work
+               by You to the Licensor shall be under the terms and conditions of
+               this License, without any additional terms or conditions.
+               Notwithstanding the above, nothing herein shall supersede or modify
+               the terms of any separate license agreement you may have executed
+               with Licensor regarding such Contributions.
+         
+            6. Trademarks. This License does not grant permission to use the trade
+               names, trademarks, service marks, or product names of the Licensor,
+               except as required for reasonable and customary use in describing the
+               origin of the Work and reproducing the content of the NOTICE file.
+         
+            7. Disclaimer of Warranty. Unless required by applicable law or
+               agreed to in writing, Licensor provides the Work (and each
+               Contributor provides its Contributions) on an "AS IS" BASIS,
+               WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+               implied, including, without limitation, any warranties or conditions
+               of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+               PARTICULAR PURPOSE. You are solely responsible for determining the
+               appropriateness of using or redistributing the Work and assume any
+               risks associated with Your exercise of permissions under this License.
+         
+            8. Limitation of Liability. In no event and under no legal theory,
+               whether in tort (including negligence), contract, or otherwise,
+               unless required by applicable law (such as deliberate and grossly
+               negligent acts) or agreed to in writing, shall any Contributor be
+               liable to You for damages, including any direct, indirect, special,
+               incidental, or consequential damages of any character arising as a
+               result of this License or out of the use or inability to use the
+               Work (including but not limited to damages for loss of goodwill,
+               work stoppage, computer failure or malfunction, or any and all
+               other commercial damages or losses), even if such Contributor
+               has been advised of the possibility of such damages.
+         
+            9. Accepting Warranty or Additional Liability. While redistributing
+               the Work or Derivative Works thereof, You may choose to offer,
+               and charge a fee for, acceptance of support, warranty, indemnity,
+               or other liability obligations and/or rights consistent with this
+               License. However, in accepting such obligations, You may act only
+               on Your own behalf and on Your sole responsibility, not on behalf
+               of any other Contributor, and only if You agree to indemnify,
+               defend, and hold each Contributor harmless for any liability
+               incurred by, or claims asserted against, such Contributor by reason
+               of your accepting any such warranty or additional liability.
+         
+            END OF TERMS AND CONDITIONS
+         
+            APPENDIX: How to apply the Apache License to your work.
+         
+               To apply the Apache License to your work, attach the following
+               boilerplate notice, with the fields enclosed by brackets "[]"
+               replaced with your own identifying information. (Don't include
+               the brackets!)  The text should be enclosed in the appropriate
+               comment syntax for the file format. We also recommend that a
+               file or class name and description of purpose be included on the
+               same "printed page" as the copyright notice for easier
+               identification within third-party archives.
+         
+            Copyright [yyyy] [name of copyright owner]
+         
+            Licensed under the Apache License, Version 2.0 (the "License");
+            you may not use this file except in compliance with the License.
+            You may obtain a copy of the License at
+         
+                http://www.apache.org/licenses/LICENSE-2.0
+         
+            Unless required by applicable law or agreed to in writing, software
+            distributed under the License is distributed on an "AS IS" BASIS,
+            WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+            See the License for the specific language governing permissions and
+            limitations under the License.
+Requires-Dist: argon2-cffi>=25.1.0
+Requires-Dist: cryptography>=50.0.0
+Requires-Dist: pyperclip>=1.11.0
+Requires-Dist: typer>=0.27.1
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# Nexvault
+
+Nexvault is a simple, secure, and developer-friendly vault for managing your sensitive secrets locally.
+
+It's built for people who want to keep API keys, passwords, tokens, and other sensitive values under their own control — without relying on a cloud service.
+
+> **Status:** Early development — V1
+
+---
+
+## Why Nexvault?
+
+As developers, we deal with secrets all the time:
+
+- API keys
+- Database credentials
+- Access tokens
+- SSH credentials
+- Environment variables
+- Application secrets
+
+Keeping these scattered across `.env` files, notes, or random config files gets messy fast.
+
+Nexvault gives you one simple local vault to store and retrieve secrets easily, while keeping you fully in control of your data.
+
+---
+
+## Features
+
+- 🔐 **Local-first** — Your vault lives on your machine. No cloud account or remote server required.
+- 💻 **Cross-platform CLI** — Works on Linux, Windows, and macOS.
+- 🖥️ **Linux GUI** — V1 includes a graphical interface for Linux, so you can browse and manage entries visually while the CLI stays available for scripting and terminal workflows.
+- 🧩 **Developer-friendly** — Built with real dev workflows in mind: env variables, API credentials, tokens, and more.
+- 📦 **Open source** — Developed out in the open, for everyone to use and improve.
+
+---
+
+## Installation
+
+Nexvault is published to PyPI, so you'll have to install it from using [pipx](https://pypa.github.io/pipx/).
+
+### 1. Install pipx (if you don't have it already)
+
+**macOS:**
+```bash
+brew install pipx
+pipx ensurepath
+```
+
+**Linux:**
+```bash
+python3 -m pip install --user pipx
+python3 -m pipx ensurepath
+```
+
+**Windows:**
+```powershell
+py -m pip install --user pipx
+py -m pipx ensurepath
+```
+
+After installing, close and reopen your terminal so the `pipx` command is available.
+
+### 2. Install Nexvault with pipx
+
+```bash
+pipx install nexvault
+```
+
+That's it! You can now run Nexvault from anywhere with:
+
+```bash
+nexvault
+```
+
+---
+
+## Usage
+
+The CLI interface is still being designed, but here's a rough idea of what it will look like:
+
+```bash
+nexvault init
+nexvault add github-token
+nexvault get github-token
+nexvault list
+```
+
+These commands are examples and may change before the V1 release.
+
+---
+
+## Security
+
+Security is at the heart of what Nexvault is trying to do.
+
+Nexvault aims to keep your sensitive data protected locally and avoid exposing it unnecessarily. That said, the project is still young, so please **don't treat it as production-grade security software yet**.
+
+Details on encryption, key management, and threat modeling will be documented as things mature.
+
+---
+
+## Project Goals
+
+Nexvault aims to be:
+
+- **Simple** — easy to pick up and use
+- **Local-first** — no mandatory cloud dependency
+- **Secure** — built with security as a core requirement, not an afterthought
+- **Developer-friendly** — feels natural from the terminal
+- **Open source** — transparent and community-driven
+- **Portable** — CLI support across major desktop platforms
+
+---
+
+## Roadmap
+
+### V1
+- [ ] Vault initialization
+- [ ] Secure vault storage
+- [ ] Add secrets
+- [ ] Retrieve secrets
+- [ ] Delete secrets
+- [ ] List vault entries
+- [ ] Cross-platform CLI
+- [ ] Linux GUI
+- [ ] Basic documentation
+- [ ] Initial security review
+
+### Future
+- [ ] Windows GUI
+- [ ] macOS GUI
+- [ ] Import/export workflows
+- [ ] Environment variable integration
+- [ ] Better shell integration
+- [ ] Automated testing and security auditing
+- [ ] Additional vault backends
+
+> The roadmap may change as the project grows.
+
+---
+
+## Contributing
+
+Contributions, ideas, bug reports, and security feedback are all welcome! 🎉
+
+To set up a local dev environment:
+
+```bash
+git clone https://github.com/Nexment-Official/Nexvault.git
+cd nexvault
+uv sync
+```
+
+Then run the CLI locally with:
+
+```bash
+uv run nexvault
+```
+
+Before opening a pull request, please check the project's issues and contribution guidelines.
+
+---
+
+## Security Issues
+
+If you find a serious security vulnerability, please **don't** report it through a public GitHub issue.
+
+Instructions for reporting security issues privately will be added before the first production release.
+
+---
+
+## License
+
+Nexvault is released under the Apache License 2.0. See [LICENSE](LICENSE) for the full text.
+
+---
+
+<p align="center">
+  Built with ❤️ for developers who want to keep their secrets under their control.
+</p>

nexvault-0.1.0/README.md

@@ -0,0 +1,181 @@
+# Nexvault
+
+Nexvault is a simple, secure, and developer-friendly vault for managing your sensitive secrets locally.
+
+It's built for people who want to keep API keys, passwords, tokens, and other sensitive values under their own control — without relying on a cloud service.
+
+> **Status:** Early development — V1
+
+---
+
+## Why Nexvault?
+
+As developers, we deal with secrets all the time:
+
+- API keys
+- Database credentials
+- Access tokens
+- SSH credentials
+- Environment variables
+- Application secrets
+
+Keeping these scattered across `.env` files, notes, or random config files gets messy fast.
+
+Nexvault gives you one simple local vault to store and retrieve secrets easily, while keeping you fully in control of your data.
+
+---
+
+## Features
+
+- 🔐 **Local-first** — Your vault lives on your machine. No cloud account or remote server required.
+- 💻 **Cross-platform CLI** — Works on Linux, Windows, and macOS.
+- 🖥️ **Linux GUI** — V1 includes a graphical interface for Linux, so you can browse and manage entries visually while the CLI stays available for scripting and terminal workflows.
+- 🧩 **Developer-friendly** — Built with real dev workflows in mind: env variables, API credentials, tokens, and more.
+- 📦 **Open source** — Developed out in the open, for everyone to use and improve.
+
+---
+
+## Installation
+
+Nexvault is published to PyPI, so you'll have to install it from using [pipx](https://pypa.github.io/pipx/).
+
+### 1. Install pipx (if you don't have it already)
+
+**macOS:**
+```bash
+brew install pipx
+pipx ensurepath
+```
+
+**Linux:**
+```bash
+python3 -m pip install --user pipx
+python3 -m pipx ensurepath
+```
+
+**Windows:**
+```powershell
+py -m pip install --user pipx
+py -m pipx ensurepath
+```
+
+After installing, close and reopen your terminal so the `pipx` command is available.
+
+### 2. Install Nexvault with pipx
+
+```bash
+pipx install nexvault
+```
+
+That's it! You can now run Nexvault from anywhere with:
+
+```bash
+nexvault
+```
+
+---
+
+## Usage
+
+The CLI interface is still being designed, but here's a rough idea of what it will look like:
+
+```bash
+nexvault init
+nexvault add github-token
+nexvault get github-token
+nexvault list
+```
+
+These commands are examples and may change before the V1 release.
+
+---
+
+## Security
+
+Security is at the heart of what Nexvault is trying to do.
+
+Nexvault aims to keep your sensitive data protected locally and avoid exposing it unnecessarily. That said, the project is still young, so please **don't treat it as production-grade security software yet**.
+
+Details on encryption, key management, and threat modeling will be documented as things mature.
+
+---
+
+## Project Goals
+
+Nexvault aims to be:
+
+- **Simple** — easy to pick up and use
+- **Local-first** — no mandatory cloud dependency
+- **Secure** — built with security as a core requirement, not an afterthought
+- **Developer-friendly** — feels natural from the terminal
+- **Open source** — transparent and community-driven
+- **Portable** — CLI support across major desktop platforms
+
+---
+
+## Roadmap
+
+### V1
+- [ ] Vault initialization
+- [ ] Secure vault storage
+- [ ] Add secrets
+- [ ] Retrieve secrets
+- [ ] Delete secrets
+- [ ] List vault entries
+- [ ] Cross-platform CLI
+- [ ] Linux GUI
+- [ ] Basic documentation
+- [ ] Initial security review
+
+### Future
+- [ ] Windows GUI
+- [ ] macOS GUI
+- [ ] Import/export workflows
+- [ ] Environment variable integration
+- [ ] Better shell integration
+- [ ] Automated testing and security auditing
+- [ ] Additional vault backends
+
+> The roadmap may change as the project grows.
+
+---
+
+## Contributing
+
+Contributions, ideas, bug reports, and security feedback are all welcome! 🎉
+
+To set up a local dev environment:
+
+```bash
+git clone https://github.com/Nexment-Official/Nexvault.git
+cd nexvault
+uv sync
+```
+
+Then run the CLI locally with:
+
+```bash
+uv run nexvault
+```
+
+Before opening a pull request, please check the project's issues and contribution guidelines.
+
+---
+
+## Security Issues
+
+If you find a serious security vulnerability, please **don't** report it through a public GitHub issue.
+
+Instructions for reporting security issues privately will be added before the first production release.
+
+---
+
+## License
+
+Nexvault is released under the Apache License 2.0. See [LICENSE](LICENSE) for the full text.
+
+---
+
+<p align="center">
+  Built with ❤️ for developers who want to keep their secrets under their control.
+</p>

nexvault-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[project]
+name = "nexvault"
+version = "0.1.0"
+description = "Nexvault is a simple, secure, and developer-friendly vault for managing your sensitive secrets locally."
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "argon2-cffi>=25.1.0",
+    "cryptography>=50.0.0",
+    "pyperclip>=1.11.0",
+    "typer>=0.27.1",
+]
+
+[project.license]
+file = "LICENSE"
+
+[[project.authors]]
+name = "Nexment"
+
+[project.scripts]
+nexvault = "nexvault.main:app"
+
+[build-system]
+requires = ["uv_build>=0.12.1,<0.13.0"]
+build-backend = "uv_build"

nexvault-0.1.0/pyproject.toml.orig

@@ -0,0 +1,23 @@
+[project]
+name = "nexvault"
+version = "0.1.0"
+description = "Nexvault is a simple, secure, and developer-friendly vault for managing your sensitive secrets locally."
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [
+    { name = "Nexment" }
+]
+requires-python = ">=3.12"
+dependencies = [
+    "argon2-cffi>=25.1.0",
+    "cryptography>=50.0.0",
+    "pyperclip>=1.11.0",
+    "typer>=0.27.1",
+]
+
+[project.scripts]
+nexvault = "nexvault.main:app"
+
+[build-system]
+requires = ["uv_build>=0.12.1,<0.13.0"]
+build-backend = "uv_build"

nexvault-0.1.0/src/nexvault/core/add.py

@@ -0,0 +1,52 @@
+import os, json, sys
+from rich import print
+import getpass
+from rich.prompt import Prompt, Confirm
+from pathlib import Path
+
+from nexvault.core.setup import check_initialisation
+from nexvault.utils.configuration import get_value
+import nexvault.crypto.encryption as encryption_methods
+from nexvault.crypto.password import authentication
+
+
+def add():
+    type = get_value("default_type")
+    if type.lower() == "password":
+        add_password()
+    elif type.lower() == "note":
+        add_note()
+    else:
+        print("[bold red]File reading error.\n[/bold red]")
+        sys.exit(1)
+
+
+def add_password():
+    print("\n[bold]Add Password.[/bold]\n")
+    name = Prompt.ask("Name", default="password")
+    username = Prompt.ask("Username", default=getpass.getuser())
+    password = Prompt.ask("Password", password=True)
+    print("\n")
+    master_password = authentication()
+    key = encryption_methods.derive_key(master_password, get_value("salt"))
+    encrypted_password = encryption_methods.encrypt_text(password, key)
+    add_password_to_file(name, username, encrypted_password)
+    print("\n✔ Password added successfully\n")
+    sys.exit(0)
+
+
+def add_password_to_file(name, username, encrypted_password):
+    try:
+        data = f"T-Password---NEW---{name}---U---{username}---P---{encrypted_password}---END\n"
+        with open(
+            f"{Path.home()}/.nexvault/{get_value('default_vault')}.enc", "a"
+        ) as f:
+            f.write(data)
+
+    except FileNotFoundError as e:
+        print("[bold red]File reading error.\n[/bold red]")
+        sys.exit(1)
+
+    except Exception:
+        print("[bold red]An unusual error! Please try again.\n[/bold red]")
+        sys.exit(1)

nexvault-0.1.0/src/nexvault/core/setup.py

@@ -0,0 +1,104 @@
+import os, sys, json, secrets
+from rich import print
+from pathlib import Path
+from rich.prompt import Prompt, Confirm
+from datetime import datetime
+
+import nexvault.crypto.password as password_methods
+
+now = datetime.now()
+
+
+def check_initialisation():
+    try:
+        if os.path.exists(f"{Path.home()}/.nexvault/config.json"):
+            return True
+        else:
+            return False
+    except Exception:
+        print("[bold red]An unusual error! Please try again.\n[/bold red]")
+        sys.exit(1)
+
+
+def initialise():
+    try:
+        if not check_initialisation():
+            print("Let's setup [bold yellow]Nexvault[/bold yellow] for you...")
+            vault_name = Prompt.ask("Enter vault name", default="new_vault")
+            while True:
+                master_password = Prompt.ask("Create a master password", password=True)
+                if master_password == "" or len(master_password) < 5:
+                    print(
+                        "[bold red]Password can't be less than 6 characters.[/bold red]"
+                    )
+                    continue
+                else:
+                    break
+            while True:
+                confirm_master_password = Prompt.ask(
+                    "Confirm your master password", password=True
+                )
+                if confirm_master_password != master_password:
+                    print("[bold red]Password doesn't match.[/bold red]")
+                    continue
+                else:
+                    break
+
+            initialise_nv(vault_name, master_password)
+
+            print("\n✔ [bold yellow]Nexvault[/bold yellow] initialized successfully at")
+            print(f"{Path.home()}/.nexvault\n")
+
+            sys.exit(0)
+
+        if check_initialisation():
+            print("[bold yellow]Nexvault[/bold yellow] is already initialized.")
+            print(
+                "Re-Initialization will [bold red]delete[/bold red] all your previous secrets and data. It is [bold red]not reversible[/bold red]."
+            )
+            confirm_delete = Confirm.ask("Do you want to continue", default=False)
+            if confirm_delete:
+                os.remove(f"{Path.home()}/.nexvault/config.json")
+                print(
+                    "\nRemoved [bold yellow]Nexvault[/bold yellow] data completely.\nRun command [bold]'nexvault init'[/bold] to re-initialize.\n"
+                )
+                sys.exit(0)
+            if not confirm_delete:
+                print("[bold red]Operation cancelled by user.[/bold red]\n")
+                sys.exit(0)
+    except Exception:
+        print("[bold red]An unusual error! Please try again.\n[/bold red]")
+        sys.exit(1)
+
+
+def initialise_nv(vault_name, password):
+    try:
+        if os.path.exists(f"{Path.home()}/.nexvault"):
+            pass
+        else:
+            os.mkdir(f"{Path.home()}/.nexvault")
+        open(f"{Path.home()}/.nexvault/config.json", "w").close()
+        path = f"{Path.home()}/.nexvault"
+        data = {
+            "version": "1",
+            "name": vault_name,
+            "path": path,
+            "default_vault": vault_name,
+            "default_type": "password",
+            "number_of_vault": 1,
+            "created_at": str(now),
+            "last_updated": str(now),
+            "clipboard_clear_seconds": 30,
+            "shell": {
+                "history": False,
+                "confirm_destructive": True,
+            },
+            "salt": secrets.token_bytes(32).hex(),
+        }
+        with open(f"{Path.home()}/.nexvault/config.json", "w") as f:
+            json.dump(data, f, indent=4)
+        password_methods.hash_password(password, True, f"{Path.home()}/.nexvault/.enc")
+
+    except Exception:
+        print("[bold red]An unusual error! Please try again.\n[/bold red]")
+        sys.exit(1)

nexvault-0.1.0/src/nexvault/core/shell.py

@@ -0,0 +1,5 @@
+from rich import print
+
+
+def start():
+    print("[bold yellow]Nexment Shell[/bold yellow] is under active development\n")

nexvault-0.1.0/src/nexvault/crypto/encryption.py

@@ -0,0 +1,34 @@
+import os
+from cryptography.hazmat.primitives.kdf.argon2 import Argon2id
+from cryptography.hazmat.primitives.ciphers.aead import ChaCha20Poly1305
+
+
+def derive_key(password, salt):
+    kdf = Argon2id(
+        salt=bytes.fromhex(salt),
+        length=32,
+        iterations=3,
+        lanes=4,
+        memory_cost=64 * 1024,
+    )
+    key = kdf.derive(password.encode("utf-8"))
+    return key
+
+
+def encrypt_text(text, key):
+    nonce = os.urandom(12)
+    cipher = ChaCha20Poly1305(key)
+
+    ciphertext = cipher.encrypt(nonce, text.encode("utf-8"), None)
+
+    return nonce + ciphertext
+
+
+def decrypt_text(data, key):
+    nonce = data[:12]
+    ciphertext = data[12:]
+    cipher = ChaCha20Poly1305(key)
+
+    text = cipher.decrypt(nonce, ciphertext, None)
+
+    return text.decode("utf-8")

nexvault-0.1.0/src/nexvault/crypto/password.py

@@ -0,0 +1,61 @@
+from argon2 import PasswordHasher
+from argon2.exceptions import VerifyMismatchError
+from rich import print
+from rich.prompt import Prompt, Confirm
+from pathlib import Path
+
+ph = PasswordHasher()
+
+
+def hash_password(password, save_to_file=False, file=""):
+    try:
+        hashed_password = ph.hash(password)
+        if not save_to_file:
+            return hashed_password
+        if save_to_file:
+            try:
+                with open(file, "w") as f:
+                    f.write(hashed_password)
+                return True
+            except FileNotFoundError:
+                print("[bold red]File not found!.\n[/bold red]")
+                sys.exit(1)
+    except Exception:
+        print("[bold red]An unusual error! Please try again.\n[/bold red]")
+        sys.exit(1)
+
+
+def verify_password(password, hashed_password="", get_from_file=False, file=""):
+    try:
+        try:
+            if not get_from_file:
+                ph.verify(hashed_password, password)
+                return True
+            else:
+                try:
+                    with open(file, "r") as f:
+                        hashed_password = f.read().strip()
+                    ph.verify(hashed_password, password)
+                    return True
+                except FileNotFoundError:
+                    print("[bold red]File not found!.\n[/bold red]")
+                    sys.exit(1)
+
+        except VerifyMismatchError:
+            return False
+
+    except Exception:
+        print("[bold red]An unusual error! Please try again.\n[/bold red]")
+        sys.exit(1)
+
+
+def authentication():
+    master_password = Prompt.ask("Enter your master password", password=True)
+    verification = verify_password(
+        master_password, get_from_file=True, file=f"{Path.home()}/.nexvault/.enc"
+    )
+    if verification:
+        return master_password
+    if not verification:
+        print("[bold red]Wrong Password\n[/bold red]")
+        sys.exit(1)

nexvault-0.1.0/src/nexvault/main.py

@@ -0,0 +1,106 @@
+import sys
+from importlib.metadata import version as get_installed_version
+
+import typer
+from rich import print
+
+import nexvault.core.add as add_secret
+from nexvault.core.setup import check_initialisation
+from nexvault.core.setup import initialise
+from nexvault.core.shell import start as start_shell
+
+app = typer.Typer(
+    help="Securely store and manage your passwords and notes with Nexvault.",
+)
+
+
+def check_init():
+    if check_initialisation():
+        pass
+    else:
+        print(
+            "\n[bold yellow]Nexvault[/bold yellow] is not initialized.\n"
+            "Run command [bold]'nexvault init'[/bold] to initialize.\n"
+        )
+        sys.exit(0)
+
+
+@app.callback(invoke_without_command=True)
+def main(
+    ctx: typer.Context,
+    get_version: bool = typer.Option(
+        False,
+        "--version",
+        "-v",
+        is_eager=True,
+        help="Show the installed Nexvault version.",
+    ),
+    update_nexvault: bool = typer.Option(
+        False,
+        "--update",
+        "-u",
+        is_eager=True,
+        help="Show instructions for updating Nexvault.",
+    ),
+):
+    """
+    Nexvault — a simple and secure vault for your secrets.
+
+    Run 'nexvault' without a command to open the interactive shell.
+    """
+
+    if get_version:
+        installed_version = get_installed_version("nexvault")
+        print(f"[bold yellow]Nexvault[/bold yellow] v{installed_version}\n")
+        sys.exit(0)
+
+    if update_nexvault:
+        installed_version = get_installed_version("nexvault")
+        print(f"[bold yellow]Nexvault[/bold yellow] v{installed_version}")
+        print(
+            "Please visit "
+            "[bold]https://docs.nexment.in/nexvault/[/bold] "
+            "to see update instructions.\n"
+        )
+        sys.exit(0)
+
+    if ctx.invoked_subcommand is None:
+        start_shell()
+
+
+@app.command(help="Initialize Nexvault and create its initial configuration.")
+def init():
+    initialise()
+
+
+@app.command(help="Add a new password or note to Nexvault.")
+def add(
+    type: str
+    | None = typer.Option(
+        None,
+        "--type",
+        "-t",
+        help="Item type. Supported types: 'password' and 'note'.",
+    ),
+):
+    check_init()
+
+    if type is None:
+        add_secret.add()
+
+    if type.lower() == "password":
+        add_secret.add_password()
+
+    elif type.lower() == "note":
+        add_secret.add_note()
+
+    else:
+        print(
+            "[bold red]Invalid type.[/bold red]\n"
+            "[bold]Supported Type: 'password' and 'note'[/bold]\n"
+        )
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    app()

nexvault-0.1.0/src/nexvault/utils/configuration.py

@@ -0,0 +1,19 @@
+import json, os, sys
+from rich import print
+from pathlib import Path
+
+
+def get_value(value="salt"):
+    try:
+        with open(f"{Path.home()}/.nexvault/config.json", "r") as f:
+            data = json.load(f)
+        value = data.get(value)
+        return value
+
+    except FileNotFoundError as e:
+        print("[bold red]File reading error.\n[/bold red]")
+        sys.exit(1)
+
+    except Exception:
+        print("[bold red]An unusual error! Please try again.\n[/bold red]")
+        sys.exit(1)