// work with EDI in your terminal

tedi CLI

The official command-line client for Tediware.

tedi is a thin client over the Tediware API. No proprietary logic and no licensed data live in the CLI itself, every command talks to the platform.

It looks up the X12 reference standard, including segments, elements, and transaction sets, and works with your own EDI files: obfuscate personal data locally, or inspect a document to see it decoded and validated. It is built to grow into a companion for the rest of the platform.

Requirements

  • Node.js 18.19 or newer, which includes npm.
  • A Tediware API key. X12 reference lookups need an account that has accepted the current service terms. Sign up, accept the terms, then create a key on the API keys page.

Install

Install the CLI globally with npm:

npm install -g @tediware/tedi

Authenticate

Sign in once with your API key. The key is entered without echo and stored locally, so it never lands in your shell history.

tedi auth login

Look up the X12 reference

Query segments, transaction sets, and elements by id:

tedi x12 seg N1      # look up a segment
tedi x12 txn 214     # look up a transaction set
tedi x12 ele 235     # look up an element and its code list
tedi x12 releases    # list supported X12 releases

Every x12 command takes --release to pick the X12 release and --format markdown for clean, uncolored output you can pipe or redirect.

Work with your own EDI files

The edi commands operate on a document you have:

tedi edi inspect invoice.edi     # decode and validate a document
tedi edi obfuscate invoice.edi   # replace personal data, runs locally

inspect sends the document to the platform and prints it decoded against the X12 standard, with envelope details, named segments and elements, and any compliance findings. Add --format markdown for uncolored output you can pipe or redirect. obfuscate runs entirely on your machine and never uploads the file.

tedi x12 txn 214 showing the transaction set structure in the terminal
Transaction set lookup: segment positions, usage, and loops.
tedi x12 seg ref showing segment elements and syntax rules in the terminal
Segment lookup: elements, requirement designators, syntax rules, and semantic notes.