A suite of tools for managing your system hosts file without ever manually editing it. Hostcraft comes in two forms — a desktop GUI for point-and-click control and a CLI for terminal-first workflows — both powered by the same shared core library.
| Component | Description | Status | Link |
|---|---|---|---|
hostcraft-core |
Shared parsing, data modelling and file I/O library | ✅ Published | crates.io |
hostcraft-cli |
Terminal interface | ✅ Published | crates.io and Releases |
hostcraft-gui |
Desktop GUI (Tauri) | 🟡 Beta | Releases |
A cross-platform desktop app built with Tauri and React. Browse your host entries in a clean list view, toggle entries on or off with a single click, search and filter by status or address family, and add new entries through a guided form — all in a polished interface with full light and dark theme support.
Download the installer for your platform from the latest release:
| Platform | Installer |
|---|---|
| macOS | .dmg |
| Windows | .msi or .exe |
| Linux | .AppImage or .deb or .rpm |
A fast, cross-platform binary with no external dependencies and no Rust installation required. Download a pre-built binary for your platform or use the one-liner install script.
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/Zaberahmed/hostcraft/main/install.sh | shWindows (PowerShell):
irm https://raw.githubusercontent.com/Zaberahamed/hostcraft/main/install.ps1 | iexVia Cargo (Rust users):
cargo install hostcraft-clihostcraft list # view all entries
sudo hostcraft add myapp.local 127.0.0.1 # add an entry
sudo hostcraft edit myapp.local --new-ip 10.0.0.1 # edit an entry
sudo hostcraft toggle myapp.local # enable / disable
sudo hostcraft remove myapp.local # remove permanently
hostcraft update # update to the latest versionWindows users: run your terminal as Administrator instead of using
sudo.
→ See cli/README.md for the full command reference, options, permissions guide, install and uninstall docs, and development notes.
hostcraft/
├── assets/ # screenshots and project media
├── core/ # hostcraft-core — shared library consumed by all tools
├── cli/ # hostcraft-cli — the terminal interface
└── gui/ # hostcraft-gui — the desktop application (Tauri + React)
Documentation:
cli/README.md— full CLI reference: all commands, options, permissions, install/uninstall, and development guidecore/README.md— API reference and integration guide forhostcraft-core- GitHub Releases — GUI installers and CLI pre-built binaries
Issues and pull requests are welcome on GitHub. If you find a bug, have a feature request, or want to improve the docs, feel free to open an issue.
If you find the project useful, leaving a ⭐ helps others discover it.
MIT — see LICENSE for details.