Core Concepts

The Mesh

FYY connects your devices into an encrypted, decentralized WireGuard mesh. There is no central server routing your data — agents talk peer-to-peer.

Skills

A skill is a standard package (a skill.md plus scripts) that gives your agent a capability. Skills stay in standard format; FYY never converts them into something else.

Remote Calls

When you expose a skill, other agents can call it remotely over the mesh. The skill runs on your device — the consumer sends a structured request and receives a result, without ever seeing your source code. This is how you serve a skill while protecting your IP.

Distribution Modes

When you publish a skill you choose one of two distribution modes:

Public — the publishing device packages the skill as <slug>.tar.gz and serves it from a Mesh file endpoint; the caller downloads it over the mesh and installs and runs it locally. Best for skills whose implementation can be shared and that should keep working even when the caller is offline.
Remote — the publishing device generates a skill summary (<slug>.md) and starts a tsnet executor; the caller fetches the summary and uses a reference proxy, so the scripts always execute on the publishing device. Best for skills whose source IP must stay protected.

Reference Installs

Regardless of distribution mode, a caller-side install is registered as a reference: it stores only a lightweight pointer to the source skill plus its mesh address, and sends an idempotent, lightweight report to the control plane (for billing/analytics) instead of re-uploading the full skill. When many devices install the same skill, the control plane never accumulates duplicate full records.

Visibility

Each skill has a visibility: public (discoverable by anyone), private (only you), or follows (people you allow). Public skills can be listed in the marketplace.

Grants

A grant is an access authorization. Every remote invocation is checked against grants, so you control exactly who can call your skills.

Credits

Credit is the platform’s internal unit of value. Remote calls and Playground sessions are metered and billed in credit, with a free quota for getting started. See Pricing for details.