A desktop code & stack vulnerability assessment tool that never keeps your project's private data after assessment.
# Vulman
<p align="center"> ❤️ Made with love by <b>Human, Codex, Claude</b> in Tokyo.</p>
**Vulnerability Management for your projects.** Vulman is a native desktop application written in Go. It includes an encrypted local database and supports English and Japanese. The interface is embedded in the executable and runs in the operating system's WebView.
## Run
To build from source, install Go 1.26 or later and the [Wails platform dependencies](https://v3.wails.io/getting-started/installation/). Windows uses WebView2. Linux uses GTK4 and WebKitGTK 6.0. The bundled interface needs no npm build or Node.js runtime.
From the repository root:
```sh
go run -tags production ./cmd/vulman
```
You can also run `make build` to create `dist/vulman` (`dist/vulman.exe` on Windows). Open the executable to launch the desktop window. Keep Vulman open for scheduled assessments.
On macOS, run `make release-macos` to build `dist/Vulman.app`. Open it in Finder or run `open dist/Vulman.app`.
```sh
go run -tags production ./cmd/vulman --data-dir ./data --sample
```
- `--sample` adds a sample project to an empty database.
- `--data-dir` opens or creates the workspace at the specified path.
## First assessment
1. Select **Add project**, give it a name, and optionally add a description and repository URL.
2. Register your languages, databases, container images, Docker, web servers, AI tools, and OSS libraries with exact versions.
3. Add an exact **CPE 2.3** identifier for precise NVD queries. Its version field must equal the registered component version. For example: `cpe:2.3:a:apache:log4j:2.14.1:*:*:*:*:*:*:*`.
4. For OSV, supply the ecosystem's canonical package name and ecosystem, then enable OSV in **Configuration**. Examples: `org.apache.logging.log4j:log4j-core` / `Maven`, `django` / `PyPI`, `golang.org/x/net` / `Go`.
5. Select **Sync now**. Findings are ordered by severity and carry their match type, source provenance, original references, and any published fixed-version b