Void Stack

What is Void Stack?

Void Stack is a developer tool that starts an entire development stack — backend, frontend, database, workers — with a single command. It scans a project directory, auto-detects frameworks (FastAPI, Vite, Express, Django, etc.) and their dependencies (Python venvs, node_modules), then runs the correct commands. Built with Rust, it offers a CLI, TUI, desktop GUI, and an MCP server for AI integration with Claude Desktop / Claude Code.

How to use Void Stack?

Install a pre-built binary from the Releases page, or build from source using Cargo. Register a project with void add my-app /path/to/project (auto-detects services) and start it with void start my-app. For an interactive dashboard, run void-tui my-app. Void Stack also provides a desktop app (void-stack-desktop) and an MCP server (void-stack-mcp) for AI tools.

Key features of Void Stack

• Multi-service start/stop individually or together
• Cross-platform: Windows, macOS, Linux (WSL, Docker)
• Auto-detection of Python, Node, Rust, Go, Flutter, Docker
• Smart commands for FastAPI, Flask, Django, Vite, Next.js, Express, and more
• Dependency checking and pre-launch hooks (venv creation, pip/npm install)
• Live logs with automatic URL detection from all services
• Code analysis: dependency graphs, anti-patterns, cyclomatic complexity, coverage
• Security audit: vulnerabilities, hardcoded secrets, injection patterns
• Technical debt tracking with metric snapshots and trend comparison
• MCP server with 20+ tools for AI integration

Use cases of Void Stack

• Starting a full-stack project (e.g., FastAPI + React) with one command
• Managing multiple microservices with different frameworks and runtimes
• Running an AI-assisted development workflow using Claude Desktop / Claude Code
• Auditing project security, code quality, and technical debt before deployment
• Cleaning disk space by scanning node_modules, venv, target, and global caches

FAQ from Void Stack

How does Void Stack detect my project's services?

Void Stack scans the project directory and identifies frameworks and runtimes (Python, Node, Rust, Go, Flutter, Docker) by looking for typical files (e.g., main.py with FastAPI imports, package.json with Vite). It then generates the appropriate start commands automatically.

Can Void Stack run on Windows, macOS, and Linux?

Yes. Pre-built binaries are available for Windows (.msi/.exe), macOS (.dmg), and Linux (.deb/.AppImage). The tool also supports WSL on Windows and Docker containers.

How do I integrate Void Stack with Claude Desktop or Claude Code?

Install the MCP server binary (void-stack-mcp) and configure it as an MCP server in your Claude tool. It exposes 20+ tools for managing services, analyzing code, and auditing security autonomously.

What are the requirements to build Void Stack from source?

You need Rust (install via rustup) and the Protobuf compiler (e.g., winget install Google.Protobuf on Windows). Then run cargo install commands for the desired components (CLI, TUI, MCP server, daemon).

How can I exclude certain files from Void Stack's analysis?

Create a .voidignore file in your project root. It uses a simplified syntax similar to .gitignore, supporting prefix paths, **/ glob suffixes, and directory names to exclude generated code, mocks, vendor folders, etc.