freeoxide:~/initiative
freeoxide --install

Install a FreeOxide tool

Every command here is checked against the project it belongs to. Where a crate isn't on crates.io yet, you get the git install rather than a command that would fail.

gpui-starter

A batteries-included starting point for native GPUI apps. The scaffold I wanted on day one.

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

gpui-query

Reactive async queries for GPUI apps. Fetch, cache, and invalidate without leaving the render tree.

cargo add gpui-query --features hook

tunnel (Freeoxide Tunnel)

Serves a local directory over an ephemeral Cloudflare Quick Tunnel. You get a public HTTPS URL in a few seconds without a Cloudflare account or any DNS setup.

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

wake (Oxiwake)

Keeps a machine awake for as long as you ask. When the OS refuses the lock it says so instead of failing quietly, and ow doctor prints what each backend can actually guarantee.

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

tunnel needs cloudflared on your PATH at runtime. The GPUI projects want a Rust nightly toolchain plus whatever platform build dependencies the repo's README lists.

freeoxide --endpoints

Machine-readable endpoints

All of it is a plain GET. Nothing to sign up for.

/llms.txt
What the initiative is, what each project does, and when to reach for one. Written for agents deciding whether a FreeOxide tool fits the job in front of them.
/*.md
A markdown twin of every page. Add .md to any path: /index.md, /about.md, /developers.md, /activity.md, /contact.md, /privacy.md.
/sitemap.xml
Every canonical URL, generated from the same list that builds the navigation, with each page's markdown twin listed alongside it.
/activity
Commits, pull requests, issues and releases across every repo, snapshotted when the site builds and refreshed on each deploy.
curl https://freeoxide.com/llms.txt
curl https://freeoxide.com/developers.md
freeoxide --source

Source, licensing and versioning

  • Every repo sits under https://github.com/freeoxide or github.com/hmziqrs, is public, and takes issues and pull requests.
  • Licensing is MIT or dual MIT / Apache-2.0 per repo. Check the LICENSE file, which wins over any summary on this site.
  • Releases are tagged in git. Changelogs live in the repo next to the code they describe, not here.
  • There is no proprietary core, no paid tier, and no telemetry in any binary.
freeoxide --agents

When an agent should reach for these tools

Decision rules rather than marketing copy. If none of these match the task, a FreeOxide tool is probably the wrong answer.

gpui-starter
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.
gpui-query
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.
tunnel
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.
wake
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.

These are tools you run, not services you call. There's no API and no key to issue. An agent uses one by running the CLI or adding the crate to a Rust project. For anything else, [email protected] reaches a human.