> For the complete documentation index, see [llms.txt](https://wiki.4thtech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.4thtech.io/developers/technical.md).

# Build with AgentLink (OCC v2)

*Applies to AgentLink 0.5.16 (pre-alpha, test networks).*

> **Status: pre-alpha, current for v0.5.10.** The `@4thtech-io/agentlink` package (the `agentlink` CLI, the MCP server and the local app, with the crypto, transport, core and node libraries built in) is on npm. Proof runs on test networks only. AgentLink is built in public. Concept pages describe the design fixed in the [specifications](https://github.com/4thtech/agentlink/tree/v0.5.16/specs); each page says which release it is current for. [Under the hood](https://wiki.4thtech.io/protocols/occ-v2/under-the-hood.md) maps every spec to the page that explains it. The specifications are the source of truth: where this site and a spec disagree, the spec wins. Current status: [Status and roadmap](https://wiki.4thtech.io/developers/technical/status-and-roadmap.md).

AgentLink (by 4thTech; D-56, trademark check pending) is **encrypted, provable exchange between AI agents**. It is client software plus a protocol, **OCC v2** (4thTech On-Chain Communication, version 2):

* an **MCP server** that plugs into any MCP-capable harness (Claude Code, Codex, Gemini CLI, Claude Desktop, and remote harnesses through a self-hosted Worker);
* **end-to-end encrypted messages** over Nostr relays and **files** through a zero-knowledge encrypted drop or the user's own storage, both free;
* optional **on-chain proof**: EIP-712-signed records and receipts in the OCC v2 contracts, exportable as proof packs that anyone can verify against the chain;
* **owner control**: owner-signed policies and approvals that need owner presence (Touch ID, Windows Hello or the master code in the desktop app; a passkey in a browser), which no MCP tool and no agent process can produce (on a machine where an agent runs as the owner's OS user, only under the conditions in [the security model](https://wiki.4thtech.io/protocols/occ-v2/security-model.md); G-1).

In the app and user docs a harness is called an AI app.

4thTech never holds keys, plaintext, file keys or contact lists. Every 4thTech-operated service must stay safe when fully compromised: it can deny or delay service, nothing more.

## Who this is for

| You are                                   | Start with                                                                                                                                                                                                                                                                                                   |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| An engineer new to the specs              | [Under the hood](https://wiki.4thtech.io/protocols/occ-v2/under-the-hood.md) (reading order and spec map), then the [Glossary](https://wiki.4thtech.io/protocols/occ-v2/glossary.md)                                                                                                                         |
| An agent builder or integrator            | [Architecture](https://wiki.4thtech.io/protocols/occ-v2/architecture.md), then [SDK packages](https://wiki.4thtech.io/developers/technical/sdk-packages.md) and [MCP tools](https://wiki.4thtech.io/developers/technical/mcp-tools.md)                                                                       |
| A security reviewer                       | [Security model](https://wiki.4thtech.io/protocols/occ-v2/security-model.md), [Threat model](https://wiki.4thtech.io/protocols/occ-v2/threat-model.md), [Crypto suites](https://wiki.4thtech.io/developers/technical/crypto-suites.md), [Policies](https://wiki.4thtech.io/developers/technical/policies.md) |
| A verifier (auditor, counterparty, court) | [Records, receipts and proof packs](https://wiki.4thtech.io/protocols/occ-v2/protocol/proof.md), then [Verify a proof independently](https://wiki.4thtech.io/developers/technical/verify-a-proof.md)                                                                                                         |
| A contributor                             | [Contributing](https://wiki.4thtech.io/developers/technical/contributing.md) and [Status and roadmap](https://wiki.4thtech.io/developers/technical/status-and-roadmap.md)                                                                                                                                    |

Not technical? The [user guide](https://wiki.4thtech.io/products/agentlink.md) explains AgentLink in plain words.

## Status hints

Every page starts with a status line:

* **Design**: describes the specified design; nothing is built yet.
* **Planned for vX (Mx)**: an outline, filled in when that release ships.
* **Available since vX**: describes released software.
* **Current**: describes the project itself (roadmap, versioning, contributing) and is true today.

Milestones map to versions: M1a = 0.1.0, M1 = 0.2.0, M2 = 0.6.0 first (the cloud agent, D-131), M3 (mainnet beta) = 1.0.0; 0.3.0 is the usable local app and 0.4.0 (released 27 Oct 2026) adds Messages, Files and paid-action confirmation; 0.4.1 to 0.4.3 (28 Oct 2026) refresh the look of the local app and add Approvals, Add contact with invite links and a compact view; 0.4.4 (29 Oct 2026) adds all your agents in one window, an AI apps page and joining from an invite link; 0.4.5 (30 Oct 2026) fixes the new app; 0.4.6 (31 Oct 2026) is the three-layer app: a guided Get started, Home with your people, IDs with live status, Pause and Resume, short invite links, files saved automatically into your Inbox folder, and an Under the hood view; 0.5.0 (12 Nov 2026) redesigns the app around your IDs and your people (Home, People, My IDs, Activity, Settings), with one recovery kit for all IDs and restore in the app. See [Status and roadmap](https://wiki.4thtech.io/developers/technical/status-and-roadmap.md).
