yoetz

yoetz

Fast CLI for routing code and media work through the right LLM path: direct API calls when available, multi-model councils when you need agreement, and browser recipes for web-only models such as ChatGPT Pro.

Yoetz is built for coding agents and terminal workflows: gitignore-aware bundles, structured JSON output, reproducible session artifacts, live model resolution, local budget checks, and multimodal inputs across OpenAI, OpenRouter, Gemini, and LiteLLM-compatible backends.

Yoetz is under active development. Command behavior may change before 1.0.

What It Does

• Bundle repository context into prompt-ready artifacts without fighting .gitignore.
• Ask one model with text, code, images, or video.
• Council multiple models in parallel when you want independent opinions.
• Review staged diffs or files with agent-readable output.
• Generate images and video through providers that expose generation APIs.
• Use browser recipes for web-only model surfaces while keeping terminal output parseable.

Install

Homebrew

brew install avivsinai/tap/yoetz
yoetz --version

Scoop

scoop bucket add avivsinai https://github.com/avivsinai/scoop-bucket
scoop install yoetz
yoetz --version

Prebuilt Binaries

Download archives and checksums from the latest GitHub release.

curl -fLO https://github.com/avivsinai/yoetz/releases/latest/download/yoetz-aarch64-apple-darwin.tar.gz
curl -fLO https://github.com/avivsinai/yoetz/releases/latest/download/SHA256SUMS.txt
shasum -a 256 -c SHA256SUMS.txt --ignore-missing
tar xzf yoetz-aarch64-apple-darwin.tar.gz
sudo mv yoetz /usr/local/bin/

Release archives are published for macOS, Linux, and Windows targets. Use sha256sum instead of shasum -a 256 on Linux.

From Source

cargo install --git https://github.com/avivsinai/yoetz --locked

Agent Skills

Yoetz also ships an agent skill so Claude Code, Codex CLI, and compatible agent runtimes know how to call the CLI safely: resolve live model IDs, keep stdout parseable, bundle large context first, and use browser recipes intentionally.

Codex / Claude Plugin Marketplace

/plugin marketplace add avivsinai/skills-marketplace
/plugin install yoetz@avivsinai-marketplace

skills.sh

npx skills add avivsinai/yoetz

skild.sh

npx skild install @avivsinai/yoetz

The skill source lives at skills/yoetz/SKILL.md and is versioned with the CLI release metadata.

First Run

Start with a command that needs no API key:

yoetz bundle -p "Summarize this project" -f README.md --format json

Then configure at least one provider. Environment variables are enough for most users:

export OPENROUTER_API_KEY=...
export OPENAI_API_KEY=...
export GEMINI_API_KEY=...

For persistent configuration:

mkdir -p ~/.config/yoetz
cat > ~/.config/yoetz/config.toml <<'EOF'
[defaults]
provider = "openrouter"
# Optional after resolving a current model ID:
# model = "<id from yoetz models resolve>"

[providers.openrouter]
base_url = "https://openrouter.ai/api/v1"
api_key_env = "OPENROUTER_API_KEY"
kind = "openai-compatible"
EOF

From a source checkout, you can start from the full example instead:

cp docs/config.example.toml ~/.config/yoetz/config.toml

Yoetz also supports YOETZ_CONFIG_PATH, repo-local ./yoetz.toml, and config profiles. See docs/config.example.toml for the shape.

Resolve live model IDs before putting them in scripts:

yoetz models sync
yoetz models frontier --format json
yoetz models frontier --family anthropic --format json

Common Workflows

Ask With File Context

MODEL_ID=$(yoetz models frontier --family openai --format json | jq -r '.[0].model.id')
yoetz ask \
  -p "Explain the error handling tradeoffs in this file" \
  -f crates/yoetz-cli/src/main.rs \
  --provider openrouter \
  --model "$MODEL_ID" \
  --format json

Review A Diff

yoetz review diff --staged --format json
yoetz review file --path crates/yoetz-core/src/bundle.rs --format json

Run A Council