WinkTerm v0.4.0

Highlights

WinkTerm v0.4.0 expands Codex integration, managed terminal automation, desktop update support, and terminal reliability. It also includes the Windows installer packaging introduced after v0.3.0.

Codex and AI setup

• Added ChatGPT Codex OAuth login and model support, including manual callback handling for remote deployments.
• Redesigned AI provider setup and isolated WinkTerm credentials from the system Codex login.
• Added real credential validation, token refresh, model checks, and Codex client-version reporting.
• Added Agent instructions and long-term memory editing through agents.md and memory.md.

Terminal reliability and automation

• Added managed terminal runs and richer external-agent terminal APIs.
• Fixed # command routing so plain shell commands cannot accidentally reuse earlier AI input or # winkterm: output.
• Added final-message delivery for providers that do not emit LangChain stream events.
• Fixed stale WebSocket output callbacks across reconnects.
• Closed every PTY during backend reload/shutdown and blocked delayed spawn races that could leave orphaned PowerShell processes.
• Added unit, reconnect, reload-race, and real browser terminal regression coverage.

Frontend and operations

• Added global toast notifications and SSH soft-delete with undo.
• Added collapsible side panels and improved narrow-layout behavior.
• Improved settings guidance, update UI, and secret retention.
• Added MSI packaging, Docker lockfile fixes, and deployment pipeline corrections.

Verification

• Backend automated tests, frontend lint/build/typecheck, terminal API and WebSocket reconnect smoke tests, and browser E2E passed before release.
• Windows MSI passed WiX validation; internal ProductVersion is 0.4.0.

Download

• WinkTerm-Windows-x64.msi — Windows x64 installer.
• SHA256: 2C675CDB2C5AA4768306DB816FEEFCCE23477393718BC7D96311715B60D5DEFA

A macOS DMG is not included in this release because the current release environment is Windows-only.

WinkTerm v0.3.0

Highlights

WinkTerm v0.3.0 is a larger external-agent and packaging release. It adds a published CLI, MCP server support, long-running WebSocket agent transport, richer SSH operations, and fixes macOS desktop startup reliability.

External Agent & CLI

• Added a WebSocket-based external agent transport at /ws/agent for long-running operations, with heartbeat behavior to avoid reverse proxy idle timeouts.
• Added the winkterm CLI package for driving a WinkTerm backend without cloning the repo.
• Published CLI usage through npm / npx winkterm, with HTTP fallback when WebSocket transport is unavailable.
• Added login, logout, and whoami commands so credentials can be stored in ~/.winkterm/cli.json instead of being passed on every command line.
• Fixed CLI upload behavior so local paths are read from the machine running the caller/CLI and sent to the WinkTerm backend correctly.

MCP Server

• Added winkterm mcp / winkterm-mcp for MCP-capable agents.
• Exposed terminal, SSH connection, SSH command, job/event, and SSH file tools through MCP.
• Added a generic winkterm_call MCP tool so agents can call newer backend methods without waiting for a CLI wrapper update.

SSH & Ops Workflow

• Added per-server ops runbooks on SSH connections, editable by both users and agents.
• Added backend and frontend support for storing, showing, and updating those runbooks in the SSH panel.
• Extended agent terminal tooling so server-specific runbook context can be used during remote operations.

Desktop & Frontend Fixes

• Fixed desktop startup polling so the app starts checking backend readiness immediately instead of waiting on a WebView loaded event that can be unreliable for inline loading HTML.
• Increased macOS backend readiness wait time so slower first launches do not get stuck on “正在启动服务...”.
• Packaged macOS as a foreground .app bundle instead of a background-only bundle.
• Aligned macOS bundle metadata and backend /health version with 0.3.0.
• Fixed frontend WebSocket URL resolution to be lazy, improving deployment/runtime URL handling.

Agent Skill & Docs

• Split the external agent HTTP API reference into its own document to keep the default skill path focused on the CLI workflow.
• Updated the winkterm-remote skill to prefer the CLI/WebSocket path, with HTTP kept as a fallback/reference path.
• Updated install guidance for npx winkterm, login flow, and agent setup.
• Added README links and packaging/build ignore cleanup.

Download

• WinkTerm-macOS-arm64.dmg for Apple Silicon macOS.
• WinkTerm-Windows-x64.msi for Windows x64.

WinkTerm v0.2.0

WinkTerm v0.2.0

Downloads

• Windows: WinkTerm.exe
• Android: WinkTerm-debug.apk (remote thin client, fill backend URL on launch)
• macOS: coming

Requires WebView2 runtime on Windows for desktop window mode.

v0.1.1 — macOS Desktop

macOS 桌面端（Apple Silicon）

修复加载完成后黑屏问题：

• 后端在载入主界面前先启动并就绪
• 桌面动态端口与 API 地址自动对齐
• 打包时不再把开发用 localhost:8000 写入静态资源

安装

1. 下载 WinkTerm-macOS-arm64.zip 并解压
2. 打开 WinkTerm.app（首次若被 Gatekeeper 拦截，请在系统设置中允许或右键「打开」）

说明

本版本仅提供 macOS arm64 安装包；Windows / Linux 后续再发。

WinkTerm v0.1.0

🎬 Promo Video

Watch on GitHub

WinkTerm — AI That Shares Your Terminal Session

The AI types directly into your shell's input line. You review, edit, press Enter. No copy-paste, no context switching.

✨ Features

• Shared PTY Session — AI and user operate in the same terminal process
• In-Terminal Chat — Type # followed by your question at your prompt
• Sidebar AI Panel — Full conversational interface with mode switching
• SSH Remote Connections — Remote servers with built-in file transfer
• Multi-Model Support — BYO LLM (OpenAI, Anthropic, Ollama, or any OpenAI-compatible)
• Docker & Desktop — docker compose up or download the desktop app
• Codespaces Ready — Click "Open in GitHub Codespaces" in README

🔥 Why WinkTerm?

Feature	WinkTerm	Warp	Tabby	Claude Code
Shared PTY	✅	❌	❌	❌
Open source	✅	❌	✅	❌
Self-hosted / BYO LLM	✅	❌	❌	✅
Web UI	✅	✅	✅	❌
SSH + file transfer	✅	❌	✅	❌
Desktop app	✅	✅	✅	❌

🚀 Quick Start

docker run -p 3000:3000 -p 8000:8000 \
  -e ANTHROPIC_API_KEY=*** \
  ghcr.io/cznorth/winkterm:latest

Then open http://localhost:3000

📖 Links

• Project Website
• Dev.to Article
• Discussions

What's new in this release

• MIT License, full English documentation, internationalized UI
• Multi-provider support (Anthropic, OpenAI, Ollama)
• Automated Docker image build and push (ghcr.io)
• GitHub Pages project website, issue/PR templates
• Promo video, badges (star history, visitor count)
• GitHub Codespaces devcontainer config
• 19 GitHub topics for discovery
• Gitee sync workflow (add GITEE_TOKEN secret to enable)