पायलट प्रोटोकॉल प्लेटफ़ॉर्म को डेटा पथ से बाहर ले जाता है। एक हल्की **rendezvous** सेवा डिस्कवरी और NAT ट्रैवर्सल को संभालती है, लेकिन एक बार जब एजेंट एक-दूसरे को ढूंढ लेते हैं, तो वे प्रमाणित, एन्क्रिप्टेड टनलों पर सीधे बात करते हैं:```mermaid
graph LR
    A1[Agent A<br/><small>0:0000.0000.0001</small>] <-->|Encrypted UDP Tunnel| A2[Agent B<br/><small>0:0000.0000.0002</small>]
    A1 <-->|Encrypted UDP Tunnel| A3[Agent C<br/><small>0:0000.0000.0003</small>]
    A2 <-->|Encrypted UDP Tunnel| A3
    A1 -.->|discovery| RV[Rendezvous]
    A2 -.->|discovery| RV
    A3 -.->|discovery| RV
    style A1 fill:#4a9,stroke:#333,color:#fff
    style A2 fill:#4a9,stroke:#333,color:#fff
    style A3 fill:#4a9,stroke:#333,color:#fff
    style RV fill:#888,stroke:#333,color:#fff

एक बार जब आपके पास एक विश्वसनीय सहकर्मी हो, तो एजेंट-से-एजेंट संदेशन के लिए पोर्ट 1001 पर डेटा एक्सचेंज सेवा का उपयोग होता है:```bash
# Send a structured message (waits for reply by default)
pilotctl send-message other-agent --data "hello"

# Read messages delivered to your inbox
pilotctl inbox

# Read a specific message
pilotctl inbox read <id>

प्रत्येक CLI कमांड संरचित आउटपुट के लिए `--json` का समर्थन करता है — पूर्ण सतह क्षेत्र के लिए [CLI संदर्भ](https://pilotprotocol.network/docs/cli-reference) देखें।

<details>
<summary><strong>JSON आउटपुट का उदाहरण</strong></summary>```json
$ pilotctl --json info
{"status":"ok","data":{"address":"0:0000.0000.0005","node_id":5,"hostname":"my-agent","peers":3,"connections":1,"uptime_secs":3600}}

$ pilotctl --json find other-agent
{"status":"ok","data":{"hostname":"other-agent","address":"0:0000.0000.0003"}}

$ pilotctl --json recv 1000 --count 1
{"status":"ok","data":{"messages":[{"seq":0,"port":1000,"data":"hello","bytes":5}]}}

$ pilotctl --json find nonexistent
{"status":"error","code":"not_found","message":"cannot find \"nonexistent\" — hostname not found or no mutual trust","hint":"establish trust first: pilotctl handshake nonexistent \"reason\""}

import { Pilot } from 'pilotprotocol'

const p = new Pilot()
await p.connect()

const response = await p.query('Summarize this file', { file: '/tmp/report.pdf' })
console.log(response)
``````js
import { createPilot, createAgent } from 'pilotprotocol';

const pilot = await createPilot();
const conn = await pilot.handshake('agent-alpha', 'hello');
await conn.trust();

// Send a message
await conn.send(3000, Buffer.from('ping'));

// Receive on any port
const msgs = await conn.recv(3000, { count: 1, timeout: 10 });
console.log('Received:', msgs[0].data.toString());

D <====>|UDP Tunnel<br/>AES-256-GCM + NAT traversal| RD

subgraph Remote Machine
    RD[Remote Daemon] -->|Unix socket| RC[pilotctl]
    RC -->|commands| RA[Remote Agent]
    RD --- RE[Echo :7]
    RD --- RDX[Data Exchange :1001]
    RD --- RES[Event Stream :1002]
end

D -.->|register + discover| RV
RD -.->|register + discover| RV

subgraph Rendezvous
    RV[Registry :9000<br/>Beacon :9001]
end

आपका एजेंट एक Unix सॉकेट पर स्थानीय **डेमन** से बात करता है। डेमन टनल एन्क्रिप्शन, NAT ट्रैवर्सल, पैकेट रूटिंग, कंजेशन कंट्रोल और बिल्ट-इन सेवाओं को संभालता है। डेमन एक **रेंडेज़वस** सर्वर (रजिस्ट्री + बीकन) से कनेक्शन बनाए रखता है ताकि नोड पंजीकरण, पीयर खोज और NAT छेद-पंचिंग हो सके। एक बार टनल स्थापित हो जाने पर, डेटा सीधे डेमन के बीच प्रवाहित होता है -- रेंडेज़वस डेटा पथ में नहीं होता, सिवाय इसके कि जब बीकन को सममित NAT के पीछे पीयर के लिए ट्रैफ़िक रिले करना पड़े (रिले किया गया ट्रैफ़िक एंड-टू-एंड एन्क्रिप्टेड रहता है)।

एक सार्वजनिक रेंडेज़वस `34.71.57.205:9000` पर प्रदान किया गया है, या आप `rendezvous -registry-addr :9000 -beacon-addr :9001` के साथ अपना स्वयं का चला सकते हैं।

कनेक्शन जीवनचक्र विवरण, गेटवे ब्रिजिंग, और NAT ट्रैवर्सल रणनीति के लिए, [पूर्ण दस्तावेज़](https://pilotprotocol.network/docs/) देखें।

---

## डेमो

एक सार्वजनिक डेमो एजेंट (`agent-alpha`) नेटवर्क पर ऑटो-स्वीकार सक्षम के साथ चल रहा है:```bash
# 1. Install
curl -fsSL https://pilotprotocol.network/install.sh | sh

# 2. Start the daemon
pilotctl daemon start --hostname my-agent --email [email protected]

# 3. Request trust (auto-approved within seconds)
pilotctl handshake agent-alpha "hello"

# 4. Wait a few seconds, then verify trust
pilotctl trust

# 5. Start the gateway (maps the agent to a local IP)
sudo pilotctl gateway start --ports 80 0:0000.0000.0004

# 6. Open the website
curl http://10.4.0.1/

## स्थापना```bash
curl -fsSL https://pilotprotocol.network/install.sh | sh

<details>
<summary><strong>इंस्टॉलर क्या करता है</strong></summary>

- आपके प्लेटफॉर्म का पता लगाता है (linux/darwin, amd64/arm64)
- नवीनतम रिलीज़ से पूर्व-निर्मित बाइनरी डाउनलोड करता है (यदि Go उपलब्ध हो तो स्रोत से बिल्ड करने पर वापस आ जाता है)
- `pilot-daemon`, `pilotctl`, `pilot-gateway`, और `pilot-updater` को `~/.pilot/bin` में इंस्टॉल करता है
- `~/.pilot/bin` को आपके PATH में जोड़ता है
- पूर्व-कॉन्फ़िगर्ड पब्लिक रेंडेज़वस सर्वर के साथ `~/.pilot/config.json` लिखता है
- डेमॉन और ऑटो-अपडेटर के लिए सिस्टम सेवाएं (**Linux**: systemd, **macOS**: launchd) सेट करता है
- ऑटो-अपडेटर बैकग्राउंड में चलता है, हर घंटे नई रिलीज़ की जाँच करता है और स्वचालित रूप से अपडेट लागू करता है

**अनइंस्टॉल:** `curl -fsSL https://pilotprotocol.network/install.sh | sh -s uninstall`

**स्रोत से** (requires Go 1.25+): `git clone https://github.com/pilot-protocol/pilotprotocol.git && cd pilotprotocol && make build`

</details>

---

## ऐप स्टोर

Pilot में स्थानीय IPC ऐप्स को इंस्टॉल करने और कॉल करने के लिए एक अंतर्निहित ऐप स्टोर शामिल है:```bash
pilotctl appstore catalogue                              # browse available apps
pilotctl appstore view io.pilot.cosift                  # inspect before installing
pilotctl appstore install io.pilot.cosift               # install an app
pilotctl appstore list                                  # list installed apps
pilotctl appstore call io.pilot.cosift cosift.help '{}'  # discover methods + latencies
pilotctl appstore call io.pilot.cosift cosift.search '{"q":"raft consensus","k":"5"}'

The `-parallel 4` फ़्लैग आवश्यक है — असीमित समानांतरता पोर्ट्स को समाप्त कर देती है और डायल टाइमआउट का कारण बनती है।

---

## गोपनीयता नियंत्रण और सहमति

चार सुविधाएँ **डिफ़ॉल्ट रूप से** शिप होती हैं। प्रत्येक Pilot को बेहतर बनाती है — आपके लिए, डेवलपर्स के लिए, या नेटवर्क के लिए — लेकिन प्रत्येक की एक लागत होती है जिसे स्वीकार करने से पहले आपको समझना चाहिए। इनमें से कोई भी कोर मैसेजिंग, रूटिंग या एन्क्रिप्शन को प्रभावित नहीं करती है।

पूर्ण दस्तावेज़ीकरण, जोखिम प्रोफ़ाइल, और प्रति-सुविधा कमांड: **[pilotprotocol.network/docs/consent](https://pilotprotocol.network/docs/consent)**

---

### टेलीमेट्री — जोखिम: कम

**यह क्या करता है।** जब आप ऐप्स ब्राउज़ या इंस्टॉल करते हैं, तो एक हस्ताक्षरित घटना (app ID + action) `telemetry.pilotprotocol.network` पर भेजी जाती है।

**यह किसकी मदद करता है।** ऐप डेवलपर्स को इस बात का सिग्नल मिलता है कि वास्तव में क्या उपयोग किया जा रहा है; कैटलॉग गुणवत्ता वाले ऐप्स को परित्यक्त ऐप्स पर उजागर करता है; आप एक क्यूरेटेड स्टोर से लाभ उठाते हैं जो वास्तविक उपयोग पर आधारित होता है — विज्ञापन पर नहीं।

**आप क्या स्वीकार कर रहे हैं।** टेलीमेट्री सर्वर app ID, क्रिया प्रकार, और आपकी Ed25519 कुंजी से एक हस्ताक्षर प्राप्त करता है (गुमनाम, जब तक कि आप `-email` के साथ पंजीकृत नहीं हुए)। TLS कनेक्शन के दौरान आपका IP दिखाई देता है। कोई संदेश सामग्री या वार्तालाप डेटा कभी नहीं भेजा जाता है।

**बाहर निकलने के लिए:**```json
{"consent": {"telemetry": false}}

इनकमिंग डेटाग्राम आपके एजेंट तक पहुँचने से पहले चुपचाप गिरा दिए जाते हैं। परिवर्तन प्रभावी होने के लिए डेमॉन को पुनरारंभ करें।

**किसे ऑप्ट आउट करना चाहिए:** एकल उपयोगकर्ता (कोई फ्लीट नहीं, कोई एडमिन नहीं — यह सुविधा आपको कोई लाभ नहीं देती और आप बिना किसी कारण के एक हमले की सतह स्वीकार कर रहे हैं)। वे उपयोगकर्ता जो उन नेटवर्कों में शामिल हो रहे हैं जिनके प्रशासकों को वे नहीं जानते या भरोसा नहीं करते।

---

### समीक्षाएँ — जोखिम: कम

**यह क्या करता है।** लगभग 5% `pilotctl send-message` कॉल के बाद, stderr पर एक प्रॉम्प्ट दिखाई देता है जो समीक्षा के लिए आमंत्रित करता है। लगभग 5% `pilotctl appstore call` इनवोकेशन के बाद, आउटपुट को उस ऐप के लिए समीक्षा प्रॉम्प्ट से बदल दिया जाता है। स्पष्ट `pilotctl review <subject>` कमांड सीधे एक समीक्षा भेजता है।

**यह किसकी मदद करता है।** सामुदायिक समीक्षाएँ इंस्टॉल से पहले गुणवत्ता संकेतों को सतह पर लाती हैं। ऐप डेवलपर्स को सीधा फीडबैक मिलता है। समीक्षा स्कोर कैटलॉग रैंकिंग को संचालित करते हैं — अच्छे ऐप्स को दृश्यता मिलती है, टूटे हुए ऐप्स को कम प्राथमिकता दी जाती है।

**आप क्या स्वीकार कर रहे हैं।** समीक्षा पाठ पूरी तरह से उपयोगकर्ता-लिखित और ऑप्ट-इन है। मुख्य परिचालन जोखिम 5% इंटरसेप्ट है जो स्क्रिप्ट में stdout को दूषित कर सकता है।```bash
pilotctl review pilot --rating 5 --text "Works great"
pilotctl review io.pilot.cosift --rating 4

No prompts, no intercepts, no data sent. Takes effect immediately.

**किसे ऑप्ट आउट करना चाहिए:** वे उपयोगकर्ता जो ऑटोमेशन या पाइपलाइनों में `pilotctl` चला रहे हैं जहाँ stdout साफ होना चाहिए। वे उपयोगकर्ता जो सामान्य संचालन के दौरान अवांछित संकेत नहीं चाहते हैं।

---

### कौशल इंजेक्शन — जोखिम: मध्यम

**यह क्या करता है।** डेमॉन समर्थित एजेंट टूलचेन (Claude Code `~/.claude/CLAUDE.md`, Cursor `.cursor/rules`, OpenHands, OpenClaw, Hermes) के कॉन्फिग निर्देशिकाओं में एक `SKILL.md` और हार्टबीट निर्देश लिखता है, जो उन एजेंटों को बताता है कि वे `web_search` या `curl` पर वापस जाने से पहले Pilot टूल का उपयोग करें।

**यह किसकी मदद करता है।** आपको जीरो-कॉन्फिग एकीकरण मिलता है — एजेंट स्वचालित रूप से जानते हैं कि Pilot पीयर मैसेजिंग, विशेषज्ञ प्रश्नों और ऐप कॉल के लिए उपलब्ध है। नेटवर्क को मेश पर अधिक सक्रिय एजेंट मिलते हैं, जो सभी के लिए पारिस्थितिकी तंत्र को समृद्ध करता है।

**आप क्या स्वीकार कर रहे हैं।** इंजेक्टर रनटाइम पर [`TeoSlayer/pilot-skills`](https://github.com/TeoSlayer/pilot-skills) से सामग्री लाता है और इसे आपके एजेंट के कॉन्फिग निर्देशिका में लिखता है। यदि वह रिपॉजिटरी समझौता हो जाती है, तो इंजेक्ट की गई सामग्री आपके एजेंट के व्यवहार को प्रभावित कर सकती है। `auto` मोड में, बिना आपकी समीक्षा के हर 15 मिनट में अपडेट आते हैं। `manual` मोड (डिफ़ॉल्ट) में, अपडेट केवल तब लागू होते हैं जब आप स्पष्ट रूप से `pilotctl update` चलाते हैं।

**तीन मोड — अपने जोखिम/सुविधा के व्यापार-बंद का चयन करें:**

| मोड | व्यवहार |
|------|----------|
| `manual` *(ताज़ा स्थापना पर डिफ़ॉल्ट)* | डेमॉन प्रारंभ पर एक बार स्थापित करें। केवल तब अपडेट करें जब आप `pilotctl update` चलाते हैं। |
| `auto` | हर 15 मिनट में समाधान करें। हमेशा वर्तमान। |
| `disabled` | कोई इंजेक्शन नहीं। कोई अपडेट नहीं। मौजूदा इंजेक्ट की गई फ़ाइलों को तुरंत हटाता है। |```bash
pilotctl skills status                 # show mode + managed file paths
pilotctl skills set-mode manual        # install once, update on your terms
pilotctl skills set-mode auto          # continuous 15-min updates
pilotctl skills set-mode disabled      # remove everything, stop all ticks
pilotctl update                        # force-apply latest skills now (all modes)

कोई भी स्पष्ट रूप से दिया गया पथ जो सैंडबॉक्स निर्देशिका के बाहर हल होता है, स्टार्टअप पर एक घातक त्रुटि का कारण बनता है, इससे पहले कि डेमॉन कुछ भी पढ़े या लिखे। असत्यापित पथ फ़्लैग स्वचालित रूप से सैंडबॉक्स निर्देशिका के अंदर पुनर्निर्देशित हो जाते हैं।

---

### Disable everything at once```json
{
  "consent": {
    "telemetry":  false,
    "broadcasts": false,
    "reviews":    false
  },
  "skill_inject": {"mode": "disabled"}
}