This project was originally an idea to simplify debugging and environment validation for developers and teams. After some brainstorming, we settled on the name Vader—not just because it sounds cool, but because it brings order to the chaos of debugging environments.
Vader is a self-hostable, open-source tool for automating environment checks, system inspections, and debugging workflows. The goal is to help developers and teams quickly verify their setup and generate structured logs without manual intervention.
With Vader, senior engineers can define diagnostic scripts, and junior engineers or contributors can execute them with a single command to collect system information, validate dependencies, and debug faster.
Video demo here: Vader Demo
- Help developers quickly diagnose and verify their local environments.
- Reduce back-and-forth debugging by generating structured reports.
- Automate environment validation with custom, reusable scripts.
- Assist open-source maintainers by ensuring bug reports contain necessary system details.
- Node.js version 16.13 or newer
- A database. Vader supports PostgreSQL
- Vader requires
pnpmto be installed if not already present. Can be done with:npm i -g pnpm
Clone the project:
git clone https://github.com/ckmonish2000/Vader.gitGo to the project directory:
cd VaderInstall dependencies:
pnpm installSet up your environment variables:
cp .env.example .env- Navigate to the backend package:
cd packages/backend- Run database migrations:
npx prisma migrate dev- Run the seed script:
pnpm run seed- Start the backend server:
pnpm run dev- In a new terminal, navigate to the dashboard package:
cd packages/dashboard- Start the development server:
pnpm run devVader provides a CLI tool to run predefined scripts.
- Run a script:
vader run <script-name>- List available scripts:
vader help- Export logs to a file:
vader run <script-id>To run this project, you will need to add the following environment variables to your .env file. You can do so using the .env.example file already present by running:
cp .env.example .envContributions are always welcome!
We'd love help improving the dashboard UI, adding more diagnostic commands, or optimizing the CLI tool. If you're interested in contributing, please check out the issues tab and open a PR.
Vader is licensed under the AGPL-3.0 / Business Source License (BUSL-1.1), ensuring that while it's open-source, commercial exploitation by cloud providers is restricted.