@trel-to/cli

CLI for Trel. Query logs, traces, exceptions, and endpoint performance with an MCP key, and upload source maps so production stacks symbolicate.

trel mcp bridges stdio clients to the hosted MCP server. Those tools cover every environment and every app in the project unless you pass environment or service.

Setup

Create an MCP key in Settings → AI Agents & MCP in your Trel dashboard. Ingest keys (trel_sk_…) also work and are the right key for CI source-map uploads.

Usage

npm install -g @trel-to/cli
# or
npx @trel-to/cli <command> [options]

Commands

| Command | Description | |---------|-------------| | logs | Fetch logs with optional filters | | exceptions | List exception groups | | exception <id> | Get exception group details; --resolve / --ack / --ignore / --assign <userId> update it | | releases | Release health: new / regressed / resolved groups, events, source maps (--all for every env) | | sourcemaps inject <dir> | Stamp each JS bundle with a debug id and write it onto the matching .map | | sourcemaps upload <dir> --release <sha> | Upload every *.map under <dir>. Add --inject to stamp debug ids first | | symbols upload <path> | Upload a ProGuard map or dSYM for a release | | logs --tail | Follow new logs (polls every 3s) | | trace <traceId> | Get full trace (spans, logs, exceptions) | | performance | List performance endpoints | | overview | Analytics overview |

Web source maps

release must match the value passed to @trel-to/browser (or React, Vue, Next.js).

export TREL_KEY=trel_sk_…
trel sourcemaps upload ./dist --release "$GIT_SHA" --inject

The Vite and webpack plugins stamp debug ids at build time. sourcemaps inject does the same thing after the build, for pipelines that do not use those plugins.

Options

• -k, --key <key> — API key (or set TREL_KEY / TREL_MCP_KEY env)
• -e, --environment <env> — production, staging, development (default: production)
• --from <ts> — Start: Unix seconds or 1h, 6h, 24h, 7d
• --to <ts> — End time (Unix seconds)

Examples

export TREL_KEY=trel_mcp_xxx
trel logs --search error
trel logs --from 1h --severity error
trel exceptions --limit 20
trel trace abc123def456
trel releases

Output

• Default: JSON (easy for AI agents to parse)
• Logs: use -o text for human-readable one-line format
• Source map upload: a table of file, debug id, size, and status