# Librpc

> librpc - gRPC framework for microservices. RpcServer and RpcClient provide base classes. loadProto loads protobuf definitions. createClientFactory builds typed service clients. hmacAuth provides authentication support. createTracer enables distributed tracing. Use for inter-service communication, building gRPC services, and service client creation.

- Skill: `aibot88/librpc` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add aibot88/librpc`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aibot88/librpc/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aibot88 (https://skillmd.com/u/aibot88)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/aibot88/librpc

---


# librpc Skill

## When to Use

- Building gRPC service implementations
- Creating clients for inter-service calls
- Adding authentication to gRPC endpoints
- Implementing distributed tracing across services

## Key Concepts

**RpcServer**: Base server class for gRPC services with middleware support.

**RpcClient**: Base client class with connection management and error handling.

**createClientFactory**: Factory that creates typed service clients with
optional logging and tracing.

## Usage Patterns

### Pattern 1: Create service server

```javascript
import { RpcServer, createService } from "@copilot-ld/librpc";

const service = createService(MyServiceImpl, proto);
const server = new RpcServer([service], config);
await server.start();
```

### Pattern 2: Create service client

```javascript
import { createClientFactory } from "@copilot-ld/librpc";

const factory = createClientFactory(logger, tracer);
const agentClient = factory.createAgentClient("localhost", 50051);
const response = await agentClient.request(message);
```

## Integration

Used by all services for gRPC communication. Works with libtype for message
types.