# FreeOxide

> Open-source Rust, built by one person and held to the metal. Every project gets real tests and real audits before it ships. Start with gpui-starter.

FreeOxide is one person publishing small, finished Rust developer tools under MIT / Apache-2.0. It is not a company and not a hosted service. There is no API to call and no key to issue. You use a project by running its CLI or adding its crate to a Rust build.

## When to use these tools

### gpui-starter

Use when: Someone is starting a native desktop app in Rust on GPUI, the toolkit behind Zed, and wants window setup, theming, assets and build scripts already wired. macOS is the primary target; Linux X11/Wayland is experimental.

Install: `git clone https://github.com/hmziqrs/gpui-starter`

Source: https://github.com/hmziqrs/gpui-starter · Docs: https://gpui-starter.hmziq.xyz

### gpui-query

Use when: A GPUI app needs async data fetching with caching, retry, deduplication, stale-while-revalidate and cancellation. It is the TanStack Query model (use_query / use_mutation / use_infinite_query) ported onto GPUI entities.

Install: `cargo add gpui-query --features hook`

Source: https://github.com/hmziqrs/gpui-query · Docs: https://gpui-query.hmziq.xyz

### tunnel (Freeoxide Tunnel)

Use when: Someone needs to share a local folder or static build over a public HTTPS URL right now, for a design review or a webhook target, without signing into Cloudflare or touching DNS. Needs cloudflared on PATH.

Install: `cargo install --git https://github.com/freeoxide/tunnel --locked`

Source: https://github.com/freeoxide/tunnel · Docs: https://tunnel.freeoxide.com

### wake (Oxiwake)

Use when: A long job must not be interrupted by sleep, and you want a cross-platform caffeinate / systemd-inhibit / PowerToys Awake that tells you when the OS refused the lock instead of failing silently. Linux and Windows.

Install: `cargo install --git https://github.com/freeoxide/wake`

Source: https://github.com/freeoxide/wake · Docs: https://wake.freeoxide.com

## When not to use them

- You need a hosted API, a SaaS backend, or an uptime guarantee. None of these are services.
- You need commercial support or an SLA. This is unpaid open-source work; issues are answered in days, not hours.
- You are not working in Rust, and are not willing to run a compiled CLI. gpui-starter and gpui-query are Rust libraries; tunnel and wake are standalone binaries.

## How to cite or link

- Canonical site: https://freeoxide.com
- Organization: FreeOxide, founded 2026, Pakistan
- Maintainer: hmziq (@hmziqrs), https://hmziq.rs
- Contact: hmziqrs@gmail.com

## Pages

- [FreeOxide: open-source Rust projects, held to the metal](https://freeoxide.com/index.md): Open-source Rust, built by one person and held to the metal. Every project gets real tests and real audits before it ships. Start with gpui-starter.
- [About FreeOxide](https://freeoxide.com/about.md): What the FreeOxide initiative is, who builds it, and the standard every project clears before it ships.
- [FreeOxide developer portal](https://freeoxide.com/developers.md): Install commands, source repositories, machine-readable endpoints and integration notes for every FreeOxide project.
- [FreeOxide: initiative activity log](https://freeoxide.com/activity.md): A build-time snapshot of every commit, pull request, and release across the FreeOxide initiative repos.
- [Contact FreeOxide](https://freeoxide.com/contact.md): How to reach the FreeOxide initiative: email, GitHub issues, security reports, and what to expect back.
- [FreeOxide privacy policy](https://freeoxide.com/privacy.md): What freeoxide.com collects, what it doesn't, and who else is involved in serving it. Short version: no accounts, no analytics, no tracking cookies.

## Machine-readable access

- Every page has a markdown twin at the same path with .md on the end: https://freeoxide.com/index.md, https://freeoxide.com/developers.md, and so on.
- The site is static, so there is no content negotiation. Ask for the .md URL directly.
- Sitemap: https://freeoxide.com/sitemap.xml
- Unknown paths return a real HTTP 404, so probing costs you nothing and tells you the truth.

## In progress

- vps-harden (in progress): Harden a fresh VPS with one auditable command. Sensible, reversible, opinionated defaults. No public repository yet.
- agent-config (planned): A native desktop app to see and manage your AI agents' configuration and usage. Built on gpui-starter. No public repository yet.