Ygg v0.1.0-alpha

Ygg v0.1.0-alpha

Ygg is a local-first coding agent for macOS and Linux. This first alpha ships
the interactive terminal UI, chronological plain and response-only print
modes, persistent branchable sessions, bounded tools, automatic context
compaction, local OpenAI-compatible endpoints, and first-class OpenAI,
Anthropic, and OpenRouter-family provider support.

This is an alpha: configuration and session APIs may change before 1.0. Ygg is
not an operating-system sandbox, and enabled command execution has the full
authority of the user running it.

Install

Install Rust 1.86 or newer and rg (ripgrep), then run:

curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/skaft-software/ygg/v0.1.0-alpha/scripts/install.sh | sh

The installer builds the pinned tag and adds Cargo's bin directory to the
startup file for zsh, bash, or POSIX sh when needed. Restart the shell, then
verify it:

ygg --version
ygg --help

Manual installation without changing a shell profile:

cargo install --locked --git https://github.com/skaft-software/ygg --tag v0.1.0-alpha --bin ygg ygg-coding-agent
export PATH="${CARGO_HOME:-$HOME/.cargo}/bin:$PATH"

Highlights

• OpenAI Chat Completions, OpenAI Responses, and Anthropic Messages behind one
  provider-independent conversation model.
• Durable append-only sessions with resume, branching, usage records,
  checkpoints, and bounded compaction.
• Workspace-trusted local configuration and inspectable filesystem resources.
• Bounded read, search, edit, write, and command tools with explicit allow and
  deny controls.
• Local-first model configuration plus cloud catalog discovery and ChatGPT
  subscription authentication.
• Native terminal scrollback, semantic rendering, visible retries, and
  cancellation that terminates complete process groups.

See the changelog
and security guidance
for the full contract and limitations.