Skip to content

Releases: linuztx/alter-zero

v0.1.2

Choose a tag to compare

@github-actions github-actions released this 15 Sep 12:52

Changed

  • The /resume picker scrolls like the /model list: on a list taller
    than the screen the highlighted session rides the middle row, so the
    sessions above and below it stay in view and each ↑/↓ scrolls the next
    one in. It used to pin the highlight to the edge it had crossed, so
    scrolling down showed one new row at the bottom and nothing beyond it,
    and scrolling back up moved the highlight over the rows already on
    screen without scrolling at all.
  • The bash tool's run_in_background now says what the flag is for — a
    dev server, a watch build, a full test suite — rather than only how it
    works, and notes that it defaults to false (the agent tool's own
    run_in_background defaults the other way). And both background launches,
    a command and a subagent alike, now answer with you will be notified with
    the final output when it finishes
    in place of you will be re-invoked: a
    result to expect rather than an internal event to brace for. Between them,
    fewer long commands run in the foreground, and fewer rounds are spent
    re-reading the interim output file for a result that arrives on its own.

Fixed

  • Telemetry now reports an update the day it happens. The daily ping names
    the app version, but its once-a-day throttle was keyed on the day alone, so
    the first launch after alter-zero update sent nothing until midnight UTC
    — and the collector's INSERT OR IGNORE dropped a same-day ping outright
    (answering 204), so even a forced one left the day's row, and the
    dashboard's Versions panel, on the old version. telemetry.json now records
    last_ping_version beside last_ping_day, a launch on a different version
    pings again, and the collector's (day, id) row is an upsert that moves the
    install onto its new version. The install id survives an update, so an
    update is still one user, never a new install. Redeploy the collector
    (cd telemetry && npx wrangler deploy); no database migration is needed.

Full changelog: v0.1.1...v0.1.2

v0.1.1

Choose a tag to compare

@github-actions github-actions released this 15 Sep 08:53

Added

  • Venice as a direct provider. /loginUse an API key
    Venice takes a key from your own Venice.ai account, and /model lists
    Venice's catalog straight from api.venice.ai — the same private,
    uncensored models the Agent Zero API reaches through its proxy, over the
    same request: the thinking mode still drives
    venice_parameters.disable_thinking, the session's prompt_cache_key
    still pins Venice's implicit prompt cache, and each model's context
    window, vision, and reasoning support are still read off its model_spec
    record. Set VENICE_API_KEY (or ALTER_ZERO_PROVIDER=venice with the key
    in .env) to launch on it directly.

Fixed

  • The running bash cell's +N lines (Ns) footer now counts from the
    moment the command started instead of copying the status indicator's
    turn timer, so a command launched a minute into a turn opens on (0s)
    rather than (60s). A subagent's session view counts its own running
    command the same way, from that call's start rather than the agent's
    whole runtime.

Full changelog: v0.1.0...v0.1.1

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 13 Sep 15:43

Alter Zero Initial Release

Added

  • An agent that works in your project. The model reads files, writes
    and edits them, and runs shell commands through an agentic tool loop.
    Parallel tool batches are announced before they run, command output
    streams live into the conversation and folds into an expandable preview,
    and long-running commands move to the background with Ctrl+B (or
    start there), with a manager band on from an empty composer.
  • Control over what runs. An inline approval prompt shows the whole
    file, diff, or command before it executes, with "allow once", a session
    or per-project rule, or a rejection carrying your instructions (Tab).
    Four permission modes — manual, edit, auto (an LLM safety
    classifier reviews routine commands), master — cycle with
    Shift+Tab and persist per project. Shell children are detached from
    the terminal so a sudo prompt fails fast instead of hijacking the UI.
  • Checkpoints and rewind. Per-directory filesystem checkpoints snapshot
    the working tree into an isolated git store each turn; Esc Esc steps
    back to an earlier message and restores the files with it.
  • Extensibility. Subagents defined in agents/*.md (built-in
    general-purpose and explore), each with its own context, model, and
    tool allowlist, and an inline session view to chat with a running one;
    skills as SKILL.md folders with a $ mention picker, the /skills
    browser, and a built-in skill-creator; MCP servers over stdio, HTTP,
    and SSE (OAuth included) managed with /mcp and alter-zero mcp;
    Claude Code-compatible lifecycle hooks in hooks.json; AGENTS.md
    project instructions with /init to write one; structured task lists
    with a live checklist; mid-turn questions to the user; a per-session
    scratchpad for temporary files.
  • Project trust. Project-level .alter-zero/ hooks and MCP servers are
    fingerprinted and inert until approved with /trust.
  • Model providers. OpenAI-compatible Chat Completions (OpenRouter, the
    Agent Zero API, Ollama Cloud), GitHub Copilot by device-code sign-in,
    OpenAI ChatGPT by browser sign-in over the Responses API, Anthropic by
    API key or Console sign-in over the Messages API, and local Ollama over
    its native /api/chat. /login connects, /model picks a model, each
    provider's catalog reports context windows, vision, and reasoning
    support, Ctrl+T cycles the thinking mode, and prompt caching is
    requested wherever the provider offers it.
  • Context management. A footer gauge of the context window, /compact
    with automatic compaction past 90%, and the Ctrl+D view of exactly
    what the next request carries (including the classifier's own context).
  • A native terminal UI. Conversation flows into the terminal's real
    scrollback under a pinned composer; streaming Markdown with tables and
    syntax-highlighted code; collapsible reasoning; clickable URLs and file
    paths (OSC 8); inline images in kitty, iTerm2, and sixel terminals with a
    half-block fallback; Ctrl+V image paste; the Ctrl+O full
    transcript; a readline-style composer with Shift+Enter newlines,
    cross-session input history, and Ctrl+R search; @ file picker and
    ! shell commands; messages that steer the running turn (Enter) or
    queue a follow-up (Tab).
  • Looks. Eleven colour themes (/theme), six banner mascots
    (/mascot), nine spinner styles (/spinner), and a searchable
    /settings menu, all remembered per directory.
  • Sessions and the command line. Every conversation is recorded;
    /resume opens a searchable picker, --continue reopens the latest
    session in the directory, --resume <id> a specific one, and a quoted
    [PROMPT] argument starts a turn directly. --help and --version are
    available, as is the mcp subcommand family.
  • Telemetry, disclosed. One anonymous daily ping (install id, version,
    OS, architecture) described in full in TELEMETRY.md, shown once at
    startup, and switched off with the Telemetry setting,
    ALTER_ZERO_TELEMETRY=0, or DO_NOT_TRACK=1.
  • One-line install. curl -fsSL https://raw.githubusercontent.com/linuztx/alter-zero/main/install.sh | sh
    picks the build for the machine, verifies its SHA-256 against the
    published checksum, and installs alter-zero into ~/.local/bin.
  • Update notice. Once a day the app asks the repository's releases page
    whether a newer version is out — one request, carrying nothing about you
    — and says so under the banner, naming the release and alter-zero update, which installs it over the running binary through the same
    checksum-verified installer. Off with the Update check setting or
    ALTER_ZERO_UPDATE_CHECK=0; TELEMETRY.md states the request in full.
  • Release tooling. A CI workflow running the project's gate (fmt,
    clippy, test, doc), the smoke suite, and the release tooling's own
    tests; a release workflow that, on a vX.Y.Z tag, verifies the version
    against this changelog, builds Linux (x86_64, arm64) and macOS (Intel,
    Apple silicon) archives with SHA-256 checksums, and publishes a GitHub
    release whose notes come from this file — driven end to end by
    scripts/release.sh, which also rehearses a release locally.

Full changelog: https://github.com/linuztx/alter-zero/commits/v0.1.0