Skip to content

Kumo 0.0.4

Choose a tag to compare

View all tags
@kumoappdev kumoappdev released this 12 May 12:33
· 39 commits to main since this release
0.0.4
72573cc

Kumo 0.0.4 is a substantial early release that expands the app beyond basic Mihomo control into local Sub-Store management, agent-oriented automation, and more reliable live runtime monitoring.

Important: Kumo is still at a very early stage. Many features are experimental, may be incomplete, and are not guaranteed to work reliably across all macOS environments, Mihomo configurations, subscription formats, or automation workflows yet. Please treat this build as an early preview, keep backups of important profiles and settings, and expect behavior and data formats to change before the project is considered stable.

Highlights

Native Sub-Store integration

This release adds the first native Kumo surface for managing a bundled local Sub-Store backend.

  • Added a bundled Sub-Store backend payload and local runtime preparation flow.
  • Added a generated Node runtime preparation step for app and release builds, keeping the large Node sidecar out of Git while still packaging it into the built app.
  • Added a native SwiftUI Sub-Store screen instead of embedding a web view.
  • Added subscription and collection management surfaces with list/detail flows.
  • Added on-demand advanced Sub-Store sheets for files, modules, artifacts, archives, share tokens, server settings, and backend logs.
  • Added backend lifecycle controls for preparing resources, starting, stopping, and restarting Sub-Store.
  • Added backend connection settings and runtime status handling so the UI can recover when resources are missing or the backend is not running.
  • Added a dedicated SubStoreStore so Sub-Store state updates do not invalidate the rest of the app UI.
  • Added SubStoreClient, Sub-Store content models, JSON value handling, and tests for the new API layer.
  • Added profile import/refresh metadata for Sub-Store generated profiles. Profiles imported from Sub-Store now remember the original download path and refresh through the current local backend URL with Clash Meta output and cache bypassing.

Agent skill installation

Kumo now ships a bundled kumo-cli Agent Skill and provides both GUI and CLI installation paths for coding-agent workflows.

  • Added an Agent Skills configuration view in the macOS app.
  • Added bundled skill assets and metadata for the kumo-cli skill.
  • Added support for installing skills into Cursor, Claude Code, Codex CLI, Gemini CLI, and generic .agents skill directories.
  • Added global and project-scope installation where supported.
  • Added status, dry-run install, install/update, and uninstall flows.
  • Added non-destructive overwrite protection: existing skill directories that were not created by Kumo are not replaced unless the user explicitly allows it.
  • Added kumo skills status, kumo skills install, and kumo skills uninstall CLI commands with JSON support for automation.
  • Added tests covering installer behavior, target mapping, state tracking, and safety rules.

CLI and automation additions

The kumo CLI now exposes more of the shared control layer used by the macOS app.

  • Added kumo substore status, prepare, start, stop, and restart commands.
  • Added kumo skills ... commands for agent skill management.
  • Improved start/restart behavior so the CLI can install the managed core when no usable core candidate is available.
  • Extended JSON-friendly command output for the new automation surfaces.
  • Updated the CLI documentation and bundled skill documentation so agents have a clearer contract for driving Kumo safely.

Fixes

Fixed live traffic getting stuck at zero

This release fixes a major runtime monitoring issue where the Overview traffic card could stop updating permanently.

Previously, the Mihomo /traffic WebSocket had no reconnect supervisor. If the stream dropped because Mihomo restarted, the controller state became stale, or a network hiccup occurred, the stream could finish and Kumo would keep showing zero traffic speeds indefinitely.

The fix adds a reusable reconnecting WebSocket supervisor for long-lived Mihomo streams.

  • Traffic, logs, and memory WebSocket streams now reconnect after transient disconnects.
  • Traffic gauges reset to an idle zero snapshot after an established stream drops, so the UI does not display stale speeds while reconnecting.
  • The WebSocket request now sends the controller secret as a Bearer token for parity with HTTP requests.
  • The traffic parser now treats Mihomo up and down as live upload/download speeds.
  • The parser now treats upTotal and downTotal as cumulative totals.
  • Overview now reads live traffic metrics from the dedicated traffic snapshot rather than relying on fallback behavior from connection snapshots.
  • Added tests for the corrected traffic payload parsing.

Fixed macOS app icon sizing

The app icon assets were regenerated with normalized padding so Kumo appears at the expected size in Finder and DMG views.

  • Fixed oversized/undersized visual appearance caused by inconsistent icon padding.
  • Updated all app icon resolutions from 16px through 1024px.
  • Improved consistency with surrounding macOS application icons.

Improved release build correctness

The release process now has stronger version and packaging checks.

  • Added explicit VERSION validation for release artifact generation.
  • Added BUILD_NUMBER support for release builds.
  • The release artifact script now verifies that Kumo.app's CFBundleShortVersionString matches the requested release version before creating a DMG.
  • Added a stable app bundle identifier setting to the Makefile.
  • Added release build integration for preparing the Sub-Store runtime before packaging.
  • Added a latest.yml manifest flow for GitHub Releases updates.
  • Added release documentation for the Sub-Store runtime payload and manifest expectations.

Improved traffic management in the app store

Kumo now manages the traffic stream more deliberately from the app state layer.

  • Added traffic stream lifecycle handling in KumoAppStore.
  • Improved live upload/download speed propagation into Overview.
  • Reduced the chance of stale traffic state after runtime changes.

Documentation and tests

  • Updated macOS interface documentation for Sub-Store and Agent Skills surfaces.
  • Updated CLI and agent-control documentation for substore and skills commands.
  • Updated profile/runtime configuration documentation for Sub-Store generated profiles.
  • Updated persistence, release, permissions, testing, and roadmap documentation to match the new runtime resources and workflows.
  • Added unit coverage for Agent Skills installation.
  • Added unit coverage for Sub-Store client and manager behavior.
  • Added unit coverage for Mihomo traffic parsing and runtime configuration changes.

Known limitations

  • This is still a very early release. Many features are not yet hardened and may fail in real-world configurations.
  • Sub-Store support is new and should be considered experimental. Some subscription formats, collection workflows, modules, artifacts, or advanced backend settings may not behave as expected yet.
  • Kumo's native Sub-Store UI talks directly to the bundled backend API, and that integration may change as the API surface stabilizes.
  • Agent skill installation supports common directory layouts, but agent tooling conventions are still evolving and may require manual adjustment in some environments.
  • Service mode, TUN handling, update installation, and system proxy behavior remain sensitive to macOS permissions and local machine state.
  • Release artifacts are intended for early testing, not for production-critical networking setups.

Assets

  • Kumo-macos-0.0.4-arm64.dmg
  • latest.yml

SHA-256 for the DMG:

c7264b664ffc2b1ac38bd5a10178df974a3eca4c6ff8d11bd9d14f12a29c5625
Assets 4
Loading