knot knot

Changelog

December 2025

v0.22.0

This release introduces agent-to-agent port forwarding capabilities, enhanced MCP support, significant UI/UX improvements, and a more robust container runtime detection system.

  • Database Migration: Database schema changes requires migrate.sql to be applied to all MySQL databases
Added
  • Agent-to-Agent Port Forwarding:
    • Added complete port management CLI with forward, list, and stop subcommands
    • Enables secure port forwarding between agents in spaces within the same zone owned by the same user
    • Implemented proper authentication and validation for port forwarding requests
    • Added tracking and management of active port forwards with automatic cleanup
  • Node Selection Service:
    • Added node selection for automatic or manual placement of containers within a zone
Changed
  • MCP (Model Context Protocol) Support:
    • Added support for on-demand tool discovery alongside native MCP tools
    • Enhanced tool discovery mechanism for better MCP integration
    • Refactored MCP handling to support multiple tool discovery approaches
  • Container Runtime Detection:
    • Improved detection with enhanced logging and error handling
    • Refactored architecture for better maintainability
    • Enhanced Apple Silicon container support
  • UI/UX Improvements:
    • Improved mobile responsiveness and UI components
    • Fixed popup closing behavior - forms no longer close accidentally when clicking outside
    • Enhanced template node management UI
  • API & Backend Enhancements:
    • Enhanced cluster information endpoints with better data structure
    • Improved space API with additional fields and validation
    • Enhanced Server-Sent Events reconnection logic for better reliability
    • Added new query utilities for cluster operations
  • Transport Layer:
    • Improved transport service for better inter-service communication
  • Security Enhancements:
    • Enhanced authentication for port forwarding operations
    • Improved token validation for API clients
    • Better error handling for sensitive operations
  • Dependencies:
    • Updated Go modules with latest security patches
    • Refreshed frontend dependencies for better compatibility
Fixed
  • Improved error handling in container operations
  • Fixed form popup auto-close issues
  • Fixed popup closing behavior

October 2025

v0.20.x
Added
  • Apple Container Support: Added support for Apple Container templates using the macOS container CLI.
Changed
  • Safari: Improved the web interface compatibility with Safari.
  • HTTP/2 Errors: HTTP/2 errors are no longer fatal, they are logged and knot continues operation.
  • UI: Minor UI improvements.
  • Cluster: Improvements to data synchronization.

September 2025

v0.19.1
Changed
  • Message History UX: Improvements to the usability of the message history.
v0.19.0

This release brings Artificial Intelligence to knot, with both a built in assistant and connectivity to use with editors and applications that support MCP.

Added
  • Model Content Protocol (MCP): Added ability to use knot servers as MCP servers exporting tools for creating and managing spaces and templates.
  • AI Assistant: Added web based AI assistant allowing control of spaces and templates including assistance in writing new templates (requires OpenAI compatible LLM).
  • Run In Space: Run commands within a space via the command line client.
  • Copy Files: Copy files between the local machine and the space.
  • Soft Keyboard: When accessing knot from a tablet the terminal window now has a soft keyboard which provides cursor keys, control key and other keys that are not generally available on the keyboard.
Changed
  • Tunnel Server: Allow running the tunnel server on the same port as the main web interface.
  • Nomad Volumes: Added support for Nomads builtin mkdir storage plugin.

July 2025

v0.18.2

This release introduces significant updates, with the most notable being a complete rewrite of the cluster mode. The new leaderless architecture ensures that all servers in the cluster are equal, eliminating the need for a designated leader. This change improves both availability and performance, allowing the system to continue functioning seamlessly even if connections between nodes are interrupted.

Added
  • Enhanced Tunneling: Tunnel functionality has been improved, enabling the creation of tunnels from a port within a space to a port on the local machine.
  • Leaf Node Support: Restructured leaf nodes to work seamlessly with the new cluster mode.
  • Cluster Management:
    • Added support for multiple servers within a location/zone.
    • Enhanced cluster startup code and introduced a cluster info API endpoint.
  • DNS Server: Implemented a basic DNS server with forwarding support.
  • Backup and Restore:
    • Added encryption to backup/restore functionality.
    • Enabled support for audit logs and configuration values in backup/restore.
  • Template Enhancements:
    • Templates can now define variables, which are made available when creating a space.
    • Added the ability to mark templates as inactive.
    • Introduced a duplicate template function for easier template management.
  • Space Management:
    • Added a “space note” feature for descriptions and notes.
    • Introduced a restart command for spaces in both the UI and CLI.
    • Enabled forwarding into spaces without requiring port specifications.
  • UI/UX Enhancements:
    • Added usage graphs for better resource monitoring.
    • Improved login screen, added white-label support, and refined the user list UI.
    • Added icons to spaces and templates, including Gravatar support in share dialogs.
  • Miscellaneous:
    • Added IP rate limiting for authentication to enhance security.
Changed
  • UI/UX Enhancements:
    • Enhanced feedback for over-quota errors and improved messaging across the UI.
  • Performance and Reliability:
    • Refined tunnel handling and connection management with improved logging and synchronization.
    • Improved data flow between servers in the same zone.
    • Extended token life to two weeks for better user experience.
  • CLI Updates:
    • Refactored CLI commands for better organization and usability.
    • Added support for managing multiple servers from the CLI.
    • Improved error handling and feedback in the CLI.
  • Code Refactoring:
    • Removed deprecated commands and unused code for a cleaner codebase.
    • Replaced the viper dependency with an internal CLI package for improved performance.
  • Audit Log:
    • Enhanced audit log handling and forwarding to clusters for better traceability.
  • Templates:
    • Added platform change warning modals to template and volume forms for better user guidance.
Fixed
  • Fixed issues with standalone spaces and manual space deletion.
  • Resolved incorrect termination of the main server loop.
  • Addressed storage quota bugs.
  • Corrected permission checks for space transfers and admin roles.
  • Fixed the SSH info window not closing properly.