@runwardy/connector

Local telemetry agent for the Wardy platform. Runs as a background daemon to collect and relay developer activity — AI coding agent events, git activity, wallet transactions, and custom events — to your Wardy workspace.

Install

npm install -g @runwardy/connector

Quick start

export WARDY_TOKEN=your_token
export WARDY_WORKSPACE_ID=your_workspace_id

wardy start
wardy status
wardy stop

CLI

| Command | Description | |---|---| | wardy start | Start the connector daemon | | wardy status | Show connection status and metrics | | wardy stop | Stop the connector | | wardy help | Print usage |

Configuration

| Variable | Description | |---|---| | WARDY_TOKEN | API token | | WARDY_WORKSPACE_ID | Workspace ID | | WARDY_CLOUD_URL | Cloud API URL (default: https://api.wardy.run) | | GITHUB_REPOS_DIR | Comma-separated directories to scan for git repos |

API

import { startConnector, stopConnector } from "@runwardy/connector";

await startConnector({
  token: "your_token",
  workspaceId: "your_workspace_id",
});

Custom events

Send arbitrary events via HTTP:

curl -X POST http://127.0.0.1:4876/events \
  -H "Content-Type: application/json" \
  -d '{"type":"deployment.started","source":"custom","payload":{"env":"production"}}'

Data sources

• Claude Code — monitors log files and process activity
• Codex — monitors process activity
• OpenCode — monitors process activity
• GitHub — scans git repos for commits and PR merges
• Wallet — monitors wallet process activity
• Custom — HTTP endpoint for any event type

Storage

Events are queued locally in ~/.wardy/connector.db (SQLite) and batched to the Wardy cloud.