Documentation

NFLTR is built on one relay. Each product's documentation lives on its own site; this page lists all of it.

Tunnels and sharing

The nfltr client, on this site: HTTP and TCP tunnels, shares, SSH, WireGuard, messages and files between machines.

💻

CLI Reference

Every nfltr command: tunnels, shares, nfltr up, nfltr config and the rest.

Reference
🌐

HTTP Tunnels

Expose a local HTTP service at a public URL.

Core
🔌

TCP and SSH Tunneling

Reach SSH, databases, and private ports behind NAT or firewalls.

Core
🔐

End-to-End Encryption

Encrypted transport between agents and verified routing.

Core
🚀

Agent-to-Agent

Direct calls between connected agents.

Core
🌐

Fleet Management

Labels and selectors for larger groups of connected agents.

Core
🌐

Cloudflare DNS Helper

Wildcard DNS records for custom hostnames.

Guide

Tutorials

Step-by-step tasks with the commands to type and the output to expect. Every step is tested against the CLI.

🌐

Share a Local Web App

Give a reviewer a link to your localhost app, protect it with a generated password, revoke it.

Tutorial
📜

Share a Log or Command Output

nfltr tail, nfltr watch and nfltr share for files, text and pipes.

Tutorial
🔑

SSH to a Machine Behind NAT

nfltr shell or nfltr tcp 22, then ssh through nfltr ssh-config, and the host-key trade-off.

Tutorial
🏠

Reach a Private LAN

nfltr wg serve --allow on the LAN, wg socks5 or wg connect from anywhere.

Tutorial
🔐

E2EE with Pairing Keys

One random key file on every machine keeps the relay out of the key exchange.

Tutorial
📨

Send Files and Messages

p2p send, a2a send, notify send and the clipboard between your machines.

Tutorial
🩺

Diagnose Connection Problems

Which check first: diagnose, status, orch doctor, orch diagnose relay.

Tutorial

Orchestration

The distributed Claude Code hub, on orch.nfltr.xyz. The core guide track: install, API key, join machines, give the hub a goal, watch, steer and stop, recover.

Quickstart: a machine joins as a node; a goal goes to the hub from a terminal or from your own Claude Code session.

nfltr node join --max-agents 2 --allow-all-tools
nfltr orch "fix the flaky cache test and push a branch with the fix"

claude mcp add nfltr -- nfltr mcp --toolset hub
🚀

Getting Started

The whole path in one page: install, API key, credentials, join machines, first goal, recover.

Guide 00
🔧

Give the Hub a Goal

nfltr orch "<goal>", the interactive hub, budget caps, hub ids and reattach, nfltr orch doctor, zero-setup local hub.

Guide 01
🤖

Many Agents Across Machines

Machine routing, parallel work, watching tasks, and steering, continuing or stopping agents through the hub.

Guide 02
📊

Dashboard Walkthrough

Your hubs, machines and keys on the hosted dashboard.

Guide 03
👥

Team Collaboration

API keys, shared nodes, one hub id per person or project, labels, and what teammates see.

Guide 04
🛠

Troubleshooting

Symptom to fix: missing nodes, tools_not_allowed, node_lost, budgets, relay restarts, reattach, and recovery.

Guide 05
💻

Use nfltr from Claude Code

Make your own Claude Code session the hub: two commands, the completion hook, permissions.

Guide
🖥

Join Machines as Nodes

nfltr node join and nfltr orch nodes: tools, repositories, machine descriptions, credentials, isolation.

Guide
🚨

From Alert to Approved Fix

An alert reaches the hub's hook, agents investigate on several machines read-only, the owner signs one fix, and it runs on the one machine that may change.

Tutorial
🏗

Build Your Own Agent Platform

A small web service drives the hub over MCP, with no model in it: teams submit tasks over HTTP, webhooks or GitHub comments, Claude Code agents run on your machines under each one's policy, and results and costs come back. With a recorded developer's day.

Tutorial

Orchestration reference

🤖

Agent Orchestration

What the hub is, how agents reach your machines, and what nfltr does and does not decide.

Core
🔧

Hub Tools

spawn_agent, send_message, stop_agent, list_agents, wait_for_agents, list_nodes: inputs, results, constraints, budgets, delivery guarantees.

Reference
💻

Orchestration CLI Reference

Every nfltr orch and nfltr node command, with its flags and an example.

Reference
📊

Dashboard

The hosted dashboard for orchestration runs, API keys, and connected machines.

Core

More guides

👁

Observe Orchestration from Anywhere

Follow runs in the hub, on its machine, or from any machine of your account.

Guide
🔌

HTTP API Examples

Integrate from CI or portals with curl over the hosted REST API.

Guide
⚖

When to Use NFLTR

When nfltr fits your work, and when it does not.

Guide
❓

FAQ

Short answers: what nfltr orch is, how it compares, what the relay sees, whose Claude account runs the agents, and where to start.

Guide
💻

Dashboard API Cookbook

Call the dashboard's API from scripts.

Guide
🎬

Demos

Recorded runs: two from a plain Claude Code session, one goal on two machines, a parallel backlog, a remote investigation, a node killed mid-job.

Demo

Relay

The transport under both, on relay.nfltr.xyz: the hosted relay at nfltr.xyz, a relay on your own network (beta), and the Go SDK.

🏠

Run Your Own Relay (Beta)

Step by step: nfltr relay serve on your Linux VM with your TLS certificate or a pinned self-signed one, one nfltr config set-relay step per machine, then nodes, goals and your own Claude Code; what works in the beta and what does not.

Beta
📦

Go SDK Reference

Embed an nfltr agent in a Go application.

Reference
📦

Go SDK Overview

What the Go SDK is for.

Reference
← Back to Home