yoke-harness 0.18.0

Universal LLM Native Harness — drives all models with discipline

Yoke — Universal LLM Native Harness

Yoke is a disciplined coding harness that drives any LLM — Claude, GPT, Gemini, DeepSeek, and more — through a unified interface with built-in context guards, skill system, and web UI.

Think of it as your own Claude Code, but model-agnostic and self-hosted.

---

Quick Start

pip install yoke-harness

yoke setup        # pick your provider, enter API key
yoke serve        # open http://localhost:8765 in your browser

Or run in the terminal:

yoke              # interactive TUI (Textual-based)

---

Supported Providers

Provider	Models
Anthropic	Claude 3.5 Sonnet, Claude 3 Opus, …
OpenAI	GPT-4o, GPT-4 Turbo, …
Google	Gemini 1.5 Pro, Gemini Flash, …
DeepSeek	deepseek-chat, deepseek-coder
Qwen (Alibaba)	qwen-max, qwen-plus
Zhipu (GLM)	glm-4, glm-4-flash
MiniMax	abab6.5-chat
Ollama	Any local model (llama3, mistral, …)

---

Features

• 40+ built-in tools — file read/write, shell exec, web fetch, grep, git, and more
• Skill system — install reusable prompt workflows from GitHub with yoke skill install <url>
• DisciplineEngine — enforces context budget, call limits, and session guards automatically
• Web UI — chat interface at localhost:8765 with file browser and session history
• TUI — full terminal UI with vim keybindings, syntax highlighting, and diff view
• MCP support — connect any MCP server (stdio / SSE / WebSocket)
• Voice input — local Whisper STT via sounddevice
• LSP bridge — integrate with VS Code and JetBrains via the bundled extension
• Multi-agent — orchestrate parallel sub-agents for large tasks

---

Installation Options

# Core only (CLI + TUI)
pip install yoke-harness

# With web server
pip install "yoke-harness[serve]"

# With LSP support
pip install "yoke-harness[lsp]"

# Everything
pip install "yoke-harness[serve,lsp]"

---

Bundled Skills

Skill	What it does
export-excel	Convert CSV / JSON / data to formatted .xlsx
fill-report	Fill templates → .docx / .md / .txt
generate-ppt	Outline → PowerPoint .pptx
bi-chart	Data → interactive Chart.js HTML
query-data	Natural language query over workspace files
read-pdf	Extract text, tables, keywords from PDF
review-pr	Review a PR or branch diff
commit	Generate and apply a conventional git commit
simplify	Review changed code for reuse and quality
install-skill	Install a new skill from GitHub URL

Install a community skill:

yoke skill install https://github.com/KKingsley/yoke-skills/tree/main/skills/my-skill

---

Configuration

All config lives in ~/.yoke/.env:

YOKE_PROVIDER=claude          # claude | openai | gemini | deepseek | qwen | zhipu | minimax | ollama
ANTHROPIC_API_KEY=sk-...
YOKE_DEFAULT_MODE=restricted  # full | restricted | readonly
YOKE_MODEL=claude-sonnet-4-5

Run yoke setup to configure interactively.

---

Contributing

See CONTRIBUTING.md to write your own skills or providers.

---

License

MIT © KKingsley