Skip to content

Jev directory

Typesafeai CLI

An agent-first CLI for System One: ask, rank, extract, verify, screen, find, and decide from the shell, with an installable agent skill. Published on PyPI.
Stars
2
Language
Python
License
MIT
Reading time
3 min
Published by
Community
Last verified
Sep 2026

About this project

CLI for TypeSafe Jev. Run it from a shell, or let an agent run it. Jev answers noul, choice, and score questions over JSON state. It does not chat, and it only sees what you send. Invalid answers fail closed. Unused speculative heads cannot act. Ranked find lines are not evidence when the document has no answer. Python 3.10+. API key: TypeSafe console. pip install typesafeai-cli is the same package. typesafe ask takes a state file and a questions file. Point each instruction at state with backticks.

Quoted from the project's README. Read the full README.

Highlights

  • Installs via pipx or pip as typesafeai-cli; requires Python 3.10+ and TYPESAFE_API_KEY.
  • Exit codes: 0 answered, 1 request failed or invalid answer, 2 bad flags or questions.
  • `typesafe decide` maps answers to yes/no/uncertain without making any HTTP call.
  • `skills install` mirrors `npx skills add` and writes a pointer into ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md, or ~/.grok/rules/typesafe-cli.md.
  • Question instructions reference state fields with backticks, e.g. "Does `message` request a refund?"

Quickstart

bash
export TYPESAFE_API_KEY=apikey_...
pipx install typesafeai-cli
typesafe ask --state-file state.json --questions-file questions.json
typesafe noul "Does this request a refund?" --state "I was charged twice."

Watch out

It is a thin, non-chatting client: it needs a TypeSafe API key, only sees the state you send, and fails closed on invalid answers.

Questions about this entry

Short answers drawn from the linked project or page.

From the Jev guides

Original write-ups on what this entry is for.

From the Jev AI model community

Posts from builders shipping with Jev right now.

Follow @typesafeai