Meno Telemetry

Privacy-First Telemetry

Secure event ingestion service for Meno CLI and Web app. Collect anonymized usage data with opt-in consent and full transparency.

View API GitHub

Built for Security & Privacy

API Key Authentication

Secure Bearer token auth. Keys hashed with SHA-256.

Anonymized by Default

No PII transmitted. Commands hashed, errors redacted.

High Performance

Batch event ingestion with efficient PostgreSQL storage.

Analytics Ready

Pre-aggregated stats for fast dashboard queries.

OPT-IN Only

Telemetry disabled by default. Users control everything.

Scalable

Handles high-volume event streams with rate limiting.

API Reference

POST /api/v1/events

Accept and persist telemetry events from CLI and Web app.

Headers:

Authorization: Bearer <API_KEY>
Content-Type: application/json

Request Body:

{
  "events": [
    {
      "eventType": "command",
      "command": "cmd_hash",
      "duration_ms": 1234,
      "exitCode": 0,
      "timestamp": "2026-02-22T10:00:00Z"
    }
  ]
}

Response:

202 Accepted{ "accepted": 5, "code": "ACCEPTED" }

Response Codes

202Accepted - Events successfully ingested

400Bad Request - Invalid payload

401Unauthorized - Invalid API key

413Payload Too Large - Exceeds 10MB

500Internal Error - Server error during processing

Getting Started

1. Generate an API Key

node scripts/generate-key.js "Your App Name"

2. Configure Your Client

TELEMETRY_ENDPOINT=https://telemetry.menohq.app/api/v1/events
TELEMETRY_API_KEY=<your-key-from-step-1>
TELEMETRY_ENABLED=true

3. Send Events

curl -X POST https://telemetry.menohq.app/api/v1/events \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"events":[{"eventType":"command",...}]}'