truo-devkit

About this project

Herramientas para operar TruoCloud desde código, desde la terminal y —pronto— desde un agente de IA. Todo sale de un solo contrato: el OpenAPI de `api.truo.cloud/v1`. | Paquete | Qué es | Estado | |---|---|---| | `@truocloud/openapi` | La especificación OpenAPI, versionada | beta | | `@truocloud/sdk` | Cliente TypeScript. **Cero dependencias** | beta | | `@truocloud/cli` | El comando `truo` | beta | | `@truocloud/mcp` | Servidor MCP para agentes | *(no existe todavía)* | **Ningún eslabón se escribe a mano.** El spec sale de los schemas Zod de los handlers de la API; de ahí salen los tipos, los métodos del SDK y los comandos del CLI. Una operación nueva que declare `x-truo-cli` aparece en el CLI en el siguiente `bun run gen`, con su ayuda, sus argumentos y sus valores válidos. Lo que sí está escrito a mano es lo que un generador no debería tocar nunca: el transporte del SDK (reintentos, idempotencia, errores, cursor) y el dispatcher del CLI. Ahí un bug cuesta caro y no queremos que se reescriba solo cada vez que la API crece.

This is a GitHub repository (source code), not a hosted HTTP API endpoint.

From the docs

Snippets taken from the repository README when available.

# CLI
npm install -g @truocloud/cli    # o: brew install truocloud/tap/truo
truo auth login

# SDK
npm install @truocloud/sdk

import { TruoClient } from "@truocloud/sdk";

const truo = new TruoClient();                    // lee TRUO_TOKEN

for await (const svc of truo.services.listAll({ family: "vps" })) {
  console.log(svc.id, svc.name);
}

const op = await truo.vps.power("svc_10432", { action: "stop" });
await truo.operations.wait(op.id);