What is the Truto CLI?

The Truto CLI is a command-line tool for managing your entire Truto integration platform from the terminal. It supports querying unified APIs, bulk-exporting data, watching for changes, diffing records, and managing MCP tokens.

What output formats does the Truto CLI support?

The CLI supports five output formats: Table, JSON, NDJSON, CSV, and YAML. Choose the format that fits your workflow — pipe JSON to jq, export CSV for spreadsheets, or stream NDJSON for log processing.

Can I use the Truto CLI for automation and scripting?

Yes. The CLI supports stdin pipe input for bulk operations, NDJSON streaming for large datasets, and can be chained with Unix tools like jq, grep, and awk. It is built for scripting and CI/CD workflows.

CLI

Your entire integration platform, from the terminal

One CLI to manage integrations, query unified APIs, bulk-export data, watch for changes, and diff records across accounts. Built for engineers who live in the terminal.

curl -fsSL https://cli.truto.one/install.sh | bash

Get started

One command to install.

No package managers, no dependencies. A single curl installs a standalone binary for your platform.

01

Install

Detects your OS and architecture, downloads the correct binary, and installs to ~/.truto/bin/truto.

curl -fsSL https://cli.truto.one/install.sh | bash

02

Authenticate

Log in with your API token. Manage multiple profiles for different environments.

truto login --token 
truto whoami

03

Upgrade

Self-updating. Check for new versions and upgrade in-place.

truto upgrade

Features

Everything you need, nothing you don’t.

A complete CLI for the Truto platform — admin resources, data-plane APIs, and power-user tools in a single binary.

01

5 Output Formats

Table, JSON, NDJSON, CSV, and YAML. Pick the format that fits your workflow — pipe JSON to jq, export CSV for spreadsheets, stream NDJSON for log processing.

02

Unified + Proxy + Custom APIs

Query normalized data with the unified API, access raw integration-specific fields with proxy, or call your own custom endpoints. All from the same CLI.

03

Bulk Export with Auto-Pagination

Export entire datasets with a single command. The CLI handles pagination automatically and streams results in your chosen format.

04

Live Watch with Change Detection

Poll any resource at a configurable interval. Only changed or new records are emitted — ideal for live dashboards and event triggers.

05

Field-Level Diff

Compare two records side-by-side, or diff the same record across two different integrated accounts. See exactly which fields changed.

06

Stdin Pipe Support

Pipe JSON or NDJSON into create commands for bulk operations. Chain CLI commands together or integrate with curl, jq, and other Unix tools.

07

Interactive Mode

A guided wizard that walks you through resource selection, operations, and parameters. Perfect for exploring the API without memorizing commands.

08

Multi-Profile Configuration

Maintain separate profiles for staging, production, and different teams. Switch between them with a single command.

09

MCP Token Management

Create, list, and manage scoped MCP tokens for any integrated account directly from the terminal.

Power features

Built for scripting and automation.

Chain commands together, pipe output to other tools, and automate complex data workflows from your terminal.

01

Export

Bulk export any resource with automatic pagination. Streams NDJSON for large datasets, or buffers JSON/CSV for files.

$ truto export crm/contacts -a acme-sf -o ndjson --out contacts.ndjson
Exported 50 records...
Exported 100 records...
Exported 247 records. Done.

$ truto export crm/contacts -a acme-sf -o csv --out contacts.csv
Exported 247 records to contacts.csv

02

Watch

Poll a resource at any interval and stream only the changes. Pipe to a processor, a webhook, or another CLI command.

$ truto watch crm/contacts -a acme-sf --interval 30
Watching... (42 records, poll every 30s)
{"id":"c_91","name":"New Lead","email":"lead@bigcorp.com"}
{"id":"c_17","status":"qualified"}

$ truto watch crm/contacts -a acme-sf | \
    while read line; do echo "Changed: $line"; done

03

Diff

Compare two records field-by-field, or diff the same record across different integrated accounts. Timestamp fields are excluded by default.

$ truto diff crm/contacts abc-123 def-456 -a acme-sf

Diff: abc-123 vs def-456
┌─────────────┬───────────────┬───────────────┐
│ Field       │ abc-123       │ def-456       │
├─────────────┼───────────────┼───────────────┤
│ email       │ old@test.com  │ new@test.com  │
│ status      │ active        │ inactive      │
└─────────────┴───────────────┴───────────────┘
2 field(s) differ

Commands

A command for everything.

Full coverage of the Truto platform — admin resources, data-plane APIs, and power-user tools. Every command supports --help.

Admin

truto integrations list
truto accounts list
truto environments list
truto sync-jobs list
truto workflows list
truto webhooks list
truto api-tokens list
truto mcp-tokens list <id>

Data plane

truto unified crm contacts -a <id>
truto proxy tickets -a <id>
truto custom /my-endpoint
truto batch requests.json
truto logs --status 200
truto schema -o openapi.yml

Power tools

truto export crm/contacts -a <id>
truto watch crm/contacts -a <id>
truto diff crm/contacts <a> <b>
truto interactive
truto open accounts
truto upgrade