Skip to main content

TypeSafe Unofficial CLI

python PyPI license

Unofficial. This project is not affiliated with, endorsed by, or supported by TypeSafe AI or OpenRouter. "TypeSafe", "Jev" and "OpenRouter" belong to their owners.

Unofficial command-line interface for TypeSafe AI System One models, on TypeSafe or OpenRouter, built on typesafe-sdk.

Install

uv tool install typesafe-unofficial-cli

It needs Python 3.14 or newer. To work on the CLI from a checkout, run make install.

Usage

Log in once per provider profile. The key is read from a hidden prompt:

typesafe auth login
typesafe -p openrouter auth login --provider openrouter

Ask questions about some text. Each question is noul, choice or score:

echo '{"billing": {"type": "noul", "instructions": "Is this billing?"}}' \
  > questions.json
typesafe ask --state "I was charged twice." --questions-file questions.json

The file can be YAML too (.yaml/.yml, or standard input), and --questions-template yaml prints a valid one to start from (see the questions file):

typesafe ask --questions-template yaml > questions.yaml
typesafe ask --state "I was charged twice." --questions-file questions.yaml

Or define the questions with flags, alone or beside a file (a flag replaces a file question of the same name; see question flags):

typesafe ask --state "I was charged twice." \
  --noul 'billing=Is this billing?' \
  --choice 'tone=What is the tone?' \
  --criterion tone=calm --criterion 'tone=angry:Hostile or upset'

Ask the same questions about many states, one JSON value per line, with several requests in flight (see batch ask):

typesafe ask --states-file states.jsonl --questions-file questions.json \
  --concurrency 8

ask and models list accept --timeout, --max-retries and repeatable --header 'Name: value'; ask also takes --extra-body FILE (JSON or YAML) with extra top-level request fields. The request id of each response is printed on stderr and is a request_id field in the records.

Profile settings are managed with config set|get|unset (provider, base_url, model, timeout, max_retries and the global output):

typesafe config set model jev-latest

Other commands: models list (TypeSafe only), auth status|logout|token and config path|list|use.

For automation set TYPESAFE_API_KEY or OPENROUTER_API_KEY; each provider reads only its own variable. Global options go before the command: -p/--profile, -o/--output (table, json, jsonl, csv, id) and -v/--verbose.

Roadmap

  • 0.1.0: scaffold, auth, profiles, ask, models list
  • 0.2.0: request options, config set|get|unset, batch ask, request ids
  • 1.0.0: every SDK capability covered, contracts frozen

Security

Report a vulnerability privately through GitHub's advisory form, not a public issue.

Contributing

See CONTRIBUTING.md.

License

See LICENSE.

Metadata

Release files for typesafe-unofficial-cli 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for typesafe-unofficial-cli 1.2.0
File Size Uploaded Provenance Actions
typesafe_unofficial_cli-1.2.0.tar.gz 133.0 kB With provenance Details for typesafe_unofficial_cli-1.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for typesafe-unofficial-cli 1.2.0
File Interpreter ABI Platform Actions
typesafe_unofficial_cli-1.2.0-py3-none-any.whl Python 3 none any Details for typesafe_unofficial_cli-1.2.0-py3-none-any.whl

Total release size: 173.2 kB

Release files / typesafe_unofficial_cli-1.2.0.tar.gz

Download URL typesafe_unofficial_cli-1.2.0.tar.gz
Size 133.0 kB
Tags Source
SHA-256 checksum
How to use checksums
956e02db293fc9674edc79957ce2fa3bce82706954edd91a2614911e3ecb23f3
BLAKE2b-256 checksum
How to use checksums
9734bb36a1ee50e93c4f3830ceff738fbfe90654deac857f1f864ea5acd63c7e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.

Transparency log

Release files / typesafe_unofficial_cli-1.2.0-py3-none-any.whl

Download URL typesafe_unofficial_cli-1.2.0-py3-none-any.whl
Size 40.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bcdfbfc7daf308351972cc22f12b9e25aafd15a4f15f75154961eb58b59b89cc
BLAKE2b-256 checksum
How to use checksums
1f12d0dba515d00fb73142fdb6fe24fca126c293a2241c57b1016ac5185b4f06
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.

Transparency log

Security for typesafe-unofficial-cli 1.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for typesafe_unofficial_cli-1.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page