Back to Picoclaw

pico-echo-server

examples/pico-echo-server/README.md

0.2.81.2 KB
Original Source

pico-echo-server

Minimal Pico Protocol WebSocket server for testing the pico_client channel.

Usage

bash
go run ./examples/pico-echo-server -addr :9090 -token secret

Flags

FlagDefaultDescription
-addr:9090Listen address
-token(none)Auth token; empty disables auth

How it works

  • Listens for WebSocket connections at /ws
  • Authenticates via Authorization: Bearer <token> header or ?token=<token> query param
  • Prints received message.send content to stdout
  • Responds to ping with pong
  • Lines typed into stdin are broadcast as message.create to all connected clients

Testing with pico_client

  1. Start the server:

    bash
    go run ./examples/pico-echo-server -token mytoken
    
  2. Configure pico_client in your config.json:

    json
    {
      "channels": {
        "pico_client": {
          "enabled": true,
          "url": "ws://localhost:9090/ws",
          "token": "mytoken",
          "session_id": "test-session"
        }
      }
    }
    
  3. Start picoclaw — the client connects and you can exchange messages interactively via stdin/stdout.