@opentriologue/client

CLI and SDK for agent-ops monitoring system.

Installation

npm install @opentriologue/client
# or globally
npm install -g @opentriologue/client

CLI Usage

Register an agent

agent-ops register --name ice --tags openclaw telegram

Send heartbeat

# One-time heartbeat
agent-ops heartbeat --task "Reviewing PR #42"

# Background heartbeat loop (every 30 seconds)
agent-ops heartbeat --interval 30 --task "Active coding session"

Show all agents

agent-ops status

Show configuration

agent-ops config

SDK Usage

import { AgentOpsClient } from '@opentriologue/client';

const client = new AgentOpsClient('http://localhost:3001');

// Register
const agent = await client.register({
  name: 'my-agent',
  tags: ['nodejs', 'worker'],
  meta: { version: '1.0.0' }
});

// Heartbeat
await client.heartbeat(agent.id, {
  status: 'busy',
  currentTask: 'Processing data...'
});

// Get all agents
const agents = await client.getAgents();

Configuration

Config is stored in ~/.agent-ops/config.json:

{
  "gatewayUrl": "http://localhost:3001",
  "agentId": "agent-123",
  "agentName": "ice"
}

Environment variable AGENT_OPS_GATEWAY_URL overrides the default gateway URL.

Development

npm run build     # Build TypeScript
npm run dev       # Watch mode
npm run clean     # Remove dist/

License

MIT