Skip to content

Releases: wxndong/mihoterm

MihoTerm v0.1.0-alpha.3

Pre-release

Choose a tag to compare

@wxndong wxndong released this 12 Aug 10:02
d0a9699

MihoTerm v0.1.0-alpha.3 is an early x86_64 Linux prerelease focused on
observable traffic, headless reachability checks, and reliable managed DNS
bootstrap.

Highlights

  • Inspect live Mihomo connections in a read-only TUI view, including host,
    network, proxy chain, rule, per-connection traffic, and aggregate real-time
    throughput.
  • Run Google, OpenAI/Codex, GitHub, or configured HTTPS probes headlessly with
    mihoterm probe --proxy NAME without changing proxy selection.
  • Prevent proxy-node DNS bootstrap cycles in managed mode. When an enabled DNS
    configuration omits proxy-server-nameserver, MihoTerm derives it from that
    profile's own default-nameserver; explicit DNS policy is preserved and the
    stored subscription profile is never rewritten.
  • Keep the persistent authenticated proxy lifecycle, reversible Bash
    integration, private profile management, and exact-PID cleanup introduced in
    alpha.2.

Install

Download the archive and SHA256SUMS, then run:

$ sha256sum -c SHA256SUMS
$ tar -xzf mihoterm-v0.1.0-alpha.3-linux-x86_64.tar.gz
$ cd mihoterm-v0.1.0-alpha.3-linux-x86_64
$ ./install.sh
$ exec "$SHELL" -l
$ mihoterm

This release currently supports x86_64 Linux. The archive contains static
MihoTerm and Mihomo executables plus checksum-pinned GeoIP/GeoSite data.

MihoTerm v0.1.0-alpha.2

Pre-release

Choose a tag to compare

@wxndong wxndong released this 27 Jul 13:46
ef50640

MihoTerm v0.1.0-alpha.2 is an early x86_64 Linux prerelease focused on a
complete, user-local proxy lifecycle.

Highlights

  • Install and run from any directory without Rust, Cargo, root, systemd, or
    distribution-specific shared libraries.
  • Keep one authenticated, user-owned Mihomo process running after the TUI
    closes.
  • Use reversible Bash proxy integration, a proxied shell, or
    mihoterm exec -- COMMAND.
  • Add, inspect in redacted form, replace, and update subscription profiles
    directly in the TUI.
  • Uninstall safely while preserving profiles by default; use --purge only
    when configuration and profiles should also be removed.
  • Read complete status messages and context-sensitive controls in narrow
    terminals, including the minimum supported 52x10 layout.

Managed mode remains rootless and loopback-only. It does not enable TUN,
iptables, transparent system-wide capture, or non-loopback listeners, and it
stops only the exact Mihomo process it started.

Install

Download the archive and SHA256SUMS, then run:

$ sha256sum -c SHA256SUMS
$ tar -xzf mihoterm-v0.1.0-alpha.2-linux-x86_64.tar.gz
$ cd mihoterm-v0.1.0-alpha.2-linux-x86_64
$ ./install.sh
$ exec "$SHELL" -l
$ mihoterm

This release currently supports x86_64 Linux. The archive contains static
MihoTerm and Mihomo executables plus checksum-pinned GeoIP/GeoSite data.

MihoTerm v0.1.0-alpha.1

Pre-release

Choose a tag to compare

@wxndong wxndong released this 26 Jul 21:16
23cc33e

MihoTerm v0.1.0-alpha.1 is the first private alpha of a tiny, keyboard-first Mihomo TUI for Linux.

Highlights

  • one self-contained x86_64 Linux archive; no Rust, Go, systemd, root access, or distribution-specific runtime required
  • guided first run with hidden subscription input
  • explicit attach mode and isolated managed mode
  • arrow-key navigation, search, confirmed proxy/mode changes, and Google/OpenAI/GitHub probes
  • protected profile import, update, rollback, and owner-only storage
  • dynamic loopback ports, random controller secrets, exact-child shutdown, and terminal restoration
  • checksum-pinned official Mihomo v1.19.29 core and standard GeoIP/GeoSite data for deterministic cold starts
  • complete MIT, Rust dependency, Mihomo, and data provenance/license notices

Install

  1. Download the archive and SHA256SUMS.
  2. Run sha256sum -c SHA256SUMS.
  3. Extract the archive and run ./mihoterm from the extracted directory.

Keep the extracted directory intact because the two executables and three standard data files belong together.

Validation

  • 75 local tests passed
  • RustSec reported no known vulnerabilities in the locked dependency graph
  • static linking, archive safety, data checksums, and byte-for-byte reproducibility passed
  • the exact release archive was exercised on CentOS 7 / Linux 3.10 with a real owner-only subscription source
  • managed Google and GitHub requests succeeded; target reachability, including OpenAI, remains dependent on the selected proxy
  • exact-parent signal shutdown removed only the managed child and runtime listeners

Alpha limitations

Only x86_64 is released in this alpha. aarch64 and armv7 packaging exists but remains unreleased until hardware validation. Live traffic and connection views are also planned for later milestones.