CLI
Your entire integration platform, from the terminal
One CLI to build integrations from API docs, manage them, query unified APIs, bulk-export data, run batch operations, and diff records across accounts. Built for engineers who live in the terminal.
curl -fsSL https://cli.truto.one/install.sh | bashGet started
One command to install.
No package managers, no dependencies. A single curl installs a standalone binary for your platform.
Install
Detects your OS and architecture, downloads the correct binary, and installs to ~/.truto/bin/truto.
curl -fsSL https://cli.truto.one/install.sh | bashAuthenticate
Log in with your API token. Manage multiple profiles for different environments.
truto login --token
truto whoami Upgrade
Self-updating. Check for new versions and upgrade in-place.
truto upgradeBuild
Build an integration from its API docs.
Build, lint, verify and apply. The integration is on your Truto team when apply finishes, with no deploy.
Build
Discovers the API from a doc or spec source (OpenAPI, Postman, Mintlify or ReadMe docs, GraphQL, or a single doc page), audits it against the pattern catalog, and writes one IntegrationFile JSON. Runs on your own Anthropic API key, or on Fireworks plus Firecrawl.
truto integrations build https://docs.acme.com/api acmeLint
Runs the static auditor over an IntegrationFile, or over a live integration by slug. No LLM, no writes. Prints findings grouped by severity.
truto integrations lint acme.integration.jsonVerify
Checks an IntegrationFile against the vendor’s OpenAPI 3.x or Swagger 2.0 document: operation coverage, verbs, body format, schemas, base URL, auth and pagination. Read-only.
truto integrations verify acme.integration.json --spec openapi.jsonApply
Pushes the IntegrationFile, config and documentation, to Truto. It audits the file first with the same rules as lint. --dry-run prints what it would apply and makes no call to the platform.
truto integrations apply acme.integration.jsonUnified mappings
Builds the mappings from an integration to a unified model, from a connected account or from API docs. Validate the MappingFile, then apply it.
truto unified-mappings build acme crm --source-url https://docs.acme.com/api --out acme.crm.json
truto unified-mappings validate acme.crm.json
truto unified-mappings apply acme.crm.jsonUse them from Claude Code or Cursor with the Truto skills. See Build.
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.
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.
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.
Bulk Export with Auto-Pagination
Export entire datasets with a single command. The CLI handles pagination automatically and streams results in your chosen format.
Batch Operations
Send multiple API requests in a single command from a JSON file. Create, update, and delete records in bulk with parallel execution and per-request status reporting.
Field-Level Diff
Compare two records side-by-side, or diff the same record across two different integrated accounts. See exactly which fields changed.
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.
Interactive Mode
A guided wizard that walks you through resource selection, operations, and parameters. Perfect for exploring the API without memorizing commands.
Multi-Profile Configuration
Maintain separate profiles for staging, production, and different teams. Switch between them with a single command.
MCP Token Management
Create, list, and manage scoped MCP tokens for any integrated account directly from the terminal.
Integration Builder
Build an integration from its API docs, lint it, verify it against the vendor’s OpenAPI document, and apply it. Then build its unified mappings.
Power features
Built for scripting and automation.
Chain commands together, pipe output to other tools, and automate complex data workflows from your terminal.
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.csvBatch
Send multiple API requests from a JSON file in a single command. Mix creates, updates, and deletes — each request runs in parallel with individual status reporting.
$ truto batch requests.json -a acme-sf
✓ POST crm/contacts → 201 (42ms)
✓ PATCH crm/contacts/c_17 → 200 (51ms)
✓ DELETE crm/contacts/c_99 → 204 (29ms)
$ cat updates.ndjson | truto batch --stdin -a acme-sf
3/3 succeeded in 112msDiff
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@example.com │ new@example.com │
│ status │ active │ inactive │
└─────────────┴─────────────────┴─────────────────┘
2 field(s) differCommands
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.ymlPower tools
truto export crm/contacts -a <id>
truto batch requests.json -a <id>
truto diff crm/contacts <a> <b>
truto interactive
truto open accounts
truto upgradeBuild
truto integrations build <docs-url>
truto integrations lint <file>
truto integrations verify <file> --spec <spec>
truto integrations apply <file>
truto unified-mappings build <slug> <model> --source-url <docs-url>
truto unified-mappings apply <file>FAQ
Common questions about the Truto CLI.
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, running batch operations, diffing records, and managing MCP tokens.
How do I install the Truto CLI?
Run a single command: curl -fsSL https://cli.truto.one/install.sh | bash. It detects your OS and architecture, downloads the correct binary, and installs automatically. No package managers or dependencies required.
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.
Can the Truto CLI build a new integration?
Yes. truto integrations build builds an integration file from the vendor’s API docs. lint and verify check it, and apply pushes it to Truto. truto unified-mappings build maps it to a unified model.
Does the Truto CLI support multiple environments?
Yes. The CLI supports multi-profile configuration for staging, production, and different teams. Switch between profiles with a single command using truto login.
Ready to manage your integrations from the terminal?
Install the Truto CLI in seconds and start querying, exporting, and automating your integration data.