# Command reference

> Source: https://truto.one/docs/cli/command-reference/

Run `truto <command> --help` for flags and filters on any command.

## Authentication and profiles

| Command | Description |
| --- | --- |
| `truto login` | Authenticate interactively or with `--token` |
| `truto logout` | Remove stored credentials |
| `truto whoami` | Show current user and team |
| `truto profiles` | List, switch, get, and set profile values |
| `truto profiles set-key` | Store Anthropic/Firecrawl keys for builds |

## Integrations

| Command | Description |
| --- | --- |
| `truto integrations` | CRUD integration definitions |
| `truto integrations init` | Scaffold a starter integration |
| `truto integrations validate` | Validate config against OpenAPI schema |
| `truto integrations tools` | List tools/methods for an integration |
| `truto integrations unified-apis` | List unified APIs for an integration |
| `truto integrations build` | AI-powered build → local JSON file |
| `truto integrations apply` | Push IntegrationFile JSON to Truto |
| `truto integrations lint` | Static audit of integration config |
| `truto integrations add-method` | Add one method to a resource |
| `truto categories` | List integration categories |

## Admin resources

| Command | Description |
| --- | --- |
| `truto accounts` | Integrated accounts (connections) |
| `truto environments` | Environments (list, get, update) |
| `truto environment-integrations` | Per-environment integration installs |
| `truto api-tokens` | API tokens (list, get) |
| `truto sync-jobs` | Sync job definitions |
| `truto sync-job-runs` | Sync job execution records |
| `truto sync-job-triggers` | Cron triggers for sync jobs |
| `truto sync-job-templates` | Reusable sync templates |
| `truto sync-job-run-states` | Key-value state for sync runs |
| `truto workflows` | Event-triggered automations |
| `truto workflow-runs` | Workflow execution records |
| `truto webhooks` | Outbound webhooks |
| `truto notification-destinations` | Slack/email alert targets |
| `truto mcp-tokens` | MCP tokens (per account) |
| `truto unified-models` | Unified model definitions |
| `truto unified-model-resource-methods` | Unified model method mappings |
| `truto environment-unified-models` | Environment unified model installs |
| `truto environment-unified-model-resource-methods` | Environment method overrides |
| `truto datastores` | S3, GCS, MongoDB, Qdrant, PostgreSQL connections |
| `truto daemons` | Background worker identities |
| `truto daemon-jobs` | Daemon job definitions |
| `truto daemon-job-runs` | Daemon job runs |
| `truto daemon-job-triggers` | Daemon cron triggers |
| `truto users` | Team members (list, get) |
| `truto team` | Team settings |
| `truto gates` | Static IP egress proxies |
| `truto docs` | Integration/model documentation rows |
| `truto link-tokens` | Truto Link connect tokens (create) |
| `truto logs` | Query platform logs |
| `truto schema` | Download OpenAPI schema |
| `truto files` | Upload files to Truto-hosted URLs |

## Data plane

| Command | Description |
| --- | --- |
| `truto unified` | Normalized unified API calls |
| `truto proxy` | Raw proxy API calls |
| `truto custom` | Custom API paths |
| `truto batch` | Batch multiple operations |
| `truto capabilities` | Discover methods for integration or account |

## Power features

| Command | Description |
| --- | --- |
| `truto export` | Bulk export with pagination |
| `truto diff` | Compare two records |
| `truto jsonata` | Evaluate JSONata locally |
| `truto open` | Open dashboard in browser |
| `truto upgrade` | Upgrade CLI binary |
| `truto interactive` | Launch interactive wizard |
| `truto context` | LLM-oriented command reference |

## Gotchas

1. **`accounts` vs `integrated-accounts`:** CLI uses `accounts`; API path is `integrated-account`.
2. **`gates` vs `static-gates`:** CLI uses `gates`; API path is `static-gate`.
3. **`export` / `diff` paths:** Slash → unified (`crm/contacts`); no slash → proxy (`tickets`). Not for admin resources.
4. **MCP tokens:** Account ID is the first positional argument, not `-a`.
5. **Optimistic locking:** `integrations update` and `unified-models update` require `version` from a prior `get`.
6. **Schema output:** `truto schema` returns YAML; use `truto schema --out file.yml`.
7. **Environment scope:** Your token scopes all commands to one environment automatically.
