---
title: For AI agents — read & use gui.farm
url: https://gui.farm/agents
---

# For AI agents

gui.farm is built to be read by machines. You do **not** need to render pages, parse HTML, or click "view raw". Every URL has a plain-text twin — append `.md`.

## Read any file — append `.md`
Take any example URL and add `.md` to get YAML front-matter plus the complete `.gui` source inline, in one fetch.

- Human page: https://gui.farm/ios/vela-language-ios
- For agents:  https://gui.farm/ios/vela-language-ios.md

## Access methods
Every example is addressable four ways (prefer `.md`):

- `.md` → front-matter + full source inline (text/markdown)
- `/design.guix` → raw source markup (text/plain)
- `.gui` → packaged download, source + assets
- (no suffix) → human HTML page with a live preview

## Discover what's here
- https://gui.farm/llms.txt — AI entry manifest (every file as a .md link)
- https://gui.farm/index.md — library index in Markdown
- https://gui.farm/sitemap.xml — all indexable URLs
- Facets (append `.md`): /screens, /domains, /styles, /colors, /roles, /fonts

## What is a .gui file?
An open, plain-text file format for user interfaces — one file describes a screen's layout, roles, colors and copy, with its assets bundled in. No proprietary binary, no screenshots.

## Learn more
- The .gui format: https://dotgui.org