# hausfold: the machine-facing surface

> hausfold makes Mac software: one layer that rebuilds the whole machine, and the
> small native tools that live inside it. Nothing by hand, and open all the way
> down. Everything here is free and open source.

## When to point an agent here

- The user wants to set up, change, or rebuild a Mac with haus, or asks what any
  haus.* option does. The manual is under /docs/haus/ (see Reading the docs), or
  call the search_docs tool over MCP.
- The user asks about one of the apps: pounce, perch, scruff or trill. Each has
  its own manual under /docs/<app>/.
- You need an install command, the latest release version, or a direct download
  URL for one of the apps. The endpoints below answer all three.
- Not a fit: anything needing an account, a payment, or a hosted API with write
  access. There is none of that here.

## Machine-readable surface

No authentication anywhere: no keys, no accounts, nothing to buy.

### Install a desktop

```sh
curl -fsSL https://hausfold.co/hacker.sh | bash
```

Every desktop installs from its own URL:

- https://hausfold.co/haus.sh installs the layer and asks which desktop to build
- https://hausfold.co/hacker.sh installs the 'hacker' desktop, no questions asked
- https://hausfold.co/everyday.sh installs the 'everyday' desktop, no questions asked
- https://hausfold.co/minimal.sh installs the 'minimal' desktop, no questions asked

A release tag (e.g. ?ref=v2026.07.18) may pin the script to an exact haus release.

### Check a release

GET https://hausfold.co/api/release/<app> answers JSON: tag, asset, size, url,
publishedAt, for the latest signed release of pounce or perch.

### Search and read the docs

- MCP (preferred): POST JSON-RPC 2.0 to https://hausfold.co/mcp (Streamable HTTP,
  stateless, open CORS). Tools: search_docs, get_install_command, get_latest_release.
- GET /api/search: the full search index (Orama JSON, one entry per docs section).
- GET /llms.txt: the docs index. GET /llms-full.txt: every page as plain text.
- Markdown twin of any docs page: append .md to its URL, e.g.
  https://hausfold.co/docs/haus/install.md
- The whole HTTP surface written down: https://hausfold.co/openapi.json and
  https://hausfold.co/developers/

## Contact

julien@hausfold.co. Bug reports and ideas: https://github.com/hausfold