ORILink Quick-Start Guide

Before You Begin

You will need:

• —Your license key (from your purchase confirmation email)
• —A machine running Windows, Linux (Ubuntu/Debian), or macOS
• —An internet connection for license activation (one-time only)

The Individual license covers unlimited agents and installations for personal use under $500K annual revenue with 5 or fewer employees.

Installation

Windows

1. 1.Download ORILink-1.0.0-Setup.exe from your purchase confirmation email
2. 2.Right-click the file → Properties → check Unblock if present → OK
3. 3.Double-click to run the installer
4. 4.Click More info → Run anyway if Windows SmartScreen appears (the installer is unsigned pending certificate — this is expected for v1.0.0)
5. 5.Follow the wizard: Welcome → License Agreement → Install
6. 6.When installation completes, open your browser and go to: http://localhost:3000/setup
7. 7.Enter your license key and click Activate ORILink

Install location

C:\Talonyx\ORILink\

Config location

C:\ProgramData\Talonyx\ORILink\config.json

Linux (Ubuntu / Debian)

1. 1.Download orilink_1.0.0_amd64.deb from your purchase confirmation email
2. 2.Open a terminal and run:

sudo dpkg -i orilink_1.0.0_amd64.deb

3. 3.The service starts automatically. Open your browser and go to: http://localhost:3000/setup
4. 4.Enter your license key and click Activate ORILink

Install location

/usr/local/lib/orilink/

Config location

~/.orilink/config.json

Service

managed by systemd (orilink.service)

macOS

macOS installer coming soon — pending Apple Developer ID code signing certificate.

In the meantime, install via npm:

npm install /path/to/orilink-individual-1.0.0.tgz

npm (Node.js — all platforms)

Requires Node.js 20 or later.

npm install /path/to/orilink-individual-1.0.0.tgz

Activating Your License

After installation, your browser will open to http://localhost:3000/setup.

1. 1.Enter the license key from your purchase confirmation email
2. 2.Click Activate ORILink
3. 3.You will see: “You're protected.”

Your license key can be activated on multiple machines. Install ORILink on as many machines as you need for your personal development work. The Individual license covers unlimited agents and installations for personal use under $500K annual revenue with 5 or fewer employees.

Verifying ORILink is Running

Open a terminal and run:

orilink status

You should see:

ORILink v1.0.0
Service:  running
Licensed: yes
Uptime:   0h 5m 12s
Dashboard: http://localhost:3000

Other CLI commands

orilink dashboard    # Open the dashboard in your browser
orilink validate     # Re-validate your license key
orilink update /path/to/orilink-1.1.0.tgz   # Install a new version

Using the SDK

ORILink exposes three factory functions:

const { createGate1, createGate2, createORILink } = require('orilink');

Gate 1 — Inbound Trust Classification

Classifies inbound content before your agent processes it.

const gate1 = createGate1({
  threshold: 0.8,
  mode: 'enforce'
});

const result = await gate1.classify(inboundContent);
// result.trust — trust score (0–1)
// result.annotation — token-level trust annotation
// result.blocked — true if content is blocked

Gate 2 — Outbound Intent Enforcement

Evaluates outbound actions before execution.

const gate2 = createGate2({
  mode: 'enforce'
});

const result = await gate2.evaluate(pendingAction);
// result.allowed — true if action is permitted
// result.intent — classified intent
// result.blocked — true if action is blocked

createORILink — Full Bidirectional Enforcement

Runs Gate 1 then Gate 2 in sequence.

const orilink = createORILink({
  gate1: { threshold: 0.8, mode: 'enforce' },
  gate2: { mode: 'enforce' }
});

// Classify inbound
const inbound = await orilink.classify(content);

// Enforce outbound
const outbound = await orilink.enforce(instruction, action);
// outbound.blocked — true if either gate blocked

Monitoring

Open the dashboard at any time:

http://localhost:3000

The dashboard shows:

• —Service status and uptime
• —License tier and activation status
• —Active gates (Gate 1 and Gate 2)
• —CLI reference

Updating ORILink

When a new version is available you will receive an email with a download link.

Windows / Linux

orilink update /path/to/orilink-1.1.0.tgz

This stops the service, replaces the SDK, and restarts automatically. Your license key and config are preserved. No re-activation required.

npm

npm install /path/to/orilink-1.1.0.tgz

Troubleshooting