Skip to content

WinkTerm v0.3.0

Choose a tag to compare

View all tags
@Cznorth Cznorth released this 02 Jul 03:13
v0.3.0
246514a

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.
Assets 4
Loading