From 30f6f26a5d2c0447a482079ca221f99786de5c82 Mon Sep 17 00:00:00 2001
From: "SYM.BOT" <dev@sym.bot>
Date: Mon, 30 Mar 2026 14:46:41 +0100
Subject: [PATCH] Rewrite Quick Start: show how any agent connects in 2 minutes

Before: "npm install && sym start" then... nothing. Reader didn't know
how their existing agent joins the mesh.

After: Three concrete steps showing shell (sym observe) and Node.js
(SymNode) integration. A developer with agents that can't communicate
now sees the path in 30 seconds.

- Step 1: Start the mesh (same as before)
- Step 2: Any agent joins with one line (CLI or Node.js code)
- Step 3: Every agent sees what matters to them (recall + peers)

Links to AI coding agents section and sym-swift for specific platforms.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 README.md | 32 +++++++++++++++++++++++++++-----
 1 file changed, 27 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 12bfce6..68eb48e 100644
--- a/README.md
+++ b/README.md
@@ -9,16 +9,38 @@ SYM is a peer-to-peer protocol that lets AI agents discover each other, share wh
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
 [![CI](https://github.com/sym-bot/sym/actions/workflows/ci.yml/badge.svg)](https://github.com/sym-bot/sym/actions/workflows/ci.yml)
 
-## Quick Start
+## Quick Start — Connect Your Agents in 2 Minutes
 
+**Step 1: Start the mesh**
 ```bash
 npm install -g @sym-bot/sym
-sym start                    # Start the mesh daemon
-sym status                   # See your node
-sym peers                    # See who's on the mesh
+sym start
+```
+
+**Step 2: Any agent joins with one line**
+
+From a shell script, cron job, or any process:
+```bash
+sym observe '{"focus":"customer asked about blue variant","issue":"out of stock","mood":{"text":"urgent","valence":-0.3,"arousal":0.6}}'
+```
+
+From Node.js:
+```javascript
+const { SymNode } = require('@sym-bot/sym');
+const node = new SymNode({ name: 'my-agent', cognitiveProfile: 'inventory tracker' });
+await node.start();
+node.remember({ focus: 'blue variant restocked', commitment: 'arriving Thursday' });
+```
+
+**Step 3: Every agent on the mesh sees what matters to them**
+```bash
+sym recall "blue variant"    # Any agent can search mesh memory
+sym peers                    # See who's connected
 ```
 
-Your agents join the mesh by installing the [SYM skill](.agents/skills/sym/SKILL.md). Two agents on the same network discover each other automatically via Bonjour. No configuration needed.
+Two agents on the same network discover each other via Bonjour — zero configuration. Agents across the internet connect via WebSocket relay. Each agent defines what it cares about through [field weights](#configuration) — SVAF filters the rest automatically.
+
+For AI coding agents (Claude Code, Copilot, Cursor), see [For AI Coding Agents](#for-ai-coding-agents) — install one skill file and your agent joins the mesh.
 
 For iOS/macOS apps, see [`sym-swift`](https://github.com/sym-bot/sym-swift).