Start here · 5 minutes
Create your first project vault
A vault belongs to a project folder. Desktop can initialize it for you; from a terminal, initialize the folder you are working in.
Option A · Start with Desktop
- 01
Download
Get the Windows installer or Linux AppImage from the download page. macOS currently requires a source build.
- 02
Choose a folder
Launch ContextVault Desktop and select the codebase or project folder you want to remember.
- 03
Record a short session
Open Record Session, give it a title, select a source, add one or two useful events, then choose Finish & save.
- 04
Review the result
Open Sessions, then Search or Prepare to explore and reuse the new context.
Option B · Start from your project terminal
bash
cd path/to/your-project
npx @aliabdm/contextvault init
npx @aliabdm/contextvault recordWhat initialization changes
It creates a
.contextvault/ folder in the current project. Your files remain local; initialization does not upload source code or conversations.Already have browser chats?
Capture and export a conversation with the extension, then import its Markdown or ZIP into this same project.
Already use Desktop?
The sidebar project selector is the active storage boundary. Terminal and Desktop should point to the same project folder to share sessions.