WinkTerm

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.