v0.3.0

ctio 0.3.0 - reuse AI Studio custom converters

Run a custom converter you built in AI Studio on new files, straight from the CLI.

• ctio studio list [search] - list your custom converters (find a converter_id)
• ctio studio run <converter_id> <file> [output] - run an existing converter on a new file (upload + run + download in one step; - streams to stdout)
• ctio studio download <converter_id> [output] - re-download a converter's most recent result

Building new converters stays in AI Studio (web or MCP); the CLI reuses ones that already exist.

Install: scoop (Windows) scoop update ctio, or download the binary for your platform below. macOS: xattr -d com.apple.quarantine ctio after download.

v0.2.0

ctio v0.2.0

Composable, single-binary CLI for the Conversion Tools API.

New in this release

• ctio describe <type> - show a converter's options, their types, defaults, and allowed values, plus a copy-paste example. No more guessing option values.
• ctio parse <file> - extract structured data from a document via the Parse API. --schema <file.json> or --schema-id <id>; key from --parse-token or CT_PARSE_TOKEN (create one at https://parse.conversiontools.io).
• ctio list --detail now shows each option's allowed values inline.

Existing commands

ctio auth, ctio convert, ctio task, ctio list.

Install

Windows (scoop):

scoop bucket add conversiontools https://github.com/conversiontools/scoop-bucket
scoop install ctio

macOS / Linux: download the matching binary below, chmod +x, and move it onto your PATH. (macOS: xattr -d com.apple.quarantine ctio to clear Gatekeeper.)

Quick start

ctio auth login
ctio describe xml_to_csv
ctio convert -t xml_to_csv data.xml out.csv --option delimiter=vertical_bar

v0.1.0 - first public release

ctio v0.1.0 - first public release

Composable, single-binary CLI for the Conversion Tools API. No runtime required.

• ctio auth login - paste a token from https://conversiontools.io/profile (multiple profiles, multi-region)
• ctio convert -t <type> <input> <output> - run a conversion (stream stdin/stdout via -, --option key=value, --url, --sandbox)
• ctio task <id> - inspect status, --wait, --download
• ctio list - browse converters (--from, --to, --ai, --custom)

Install (Windows / scoop)

scoop bucket add conversiontools https://github.com/conversiontools/scoop-bucket
scoop install ctio

macOS / Linux: download the matching binary below, chmod +x, and move it onto your PATH. (macOS: xattr -d com.apple.quarantine ctio to clear Gatekeeper.)