2026-09-15 13:17:35 +00:00
2026-07-16 06:46:02 +01:00
2026-09-19 17:07:56 +00:00
2026-07-16 06:46:02 +01:00
2026-07-16 06:46:02 +01:00
2026-09-29 11:19:53 +00:00
2026-09-29 16:57:09 +00:00

mio-code

mio-code is a terminal coding assistant maintained by hoshizukimio. Run mio for the interactive TUI, mio -p for scripting, or mio agent stdio for editor integration through the Agent Client Protocol (ACP).

Build

Use the pinned Rust toolchain in rust-toolchain.toml, a C/C++ toolchain and CMake, and Protocol Buffers protoc 29.3. On Windows, use the MSVC x64 Developer PowerShell and set $env:PROTOC to the path to protoc.exe. On Linux, set PROTOC to the compiler path or install DotSlash to use bin/protoc. Linux builds may also require pkg-config, ALSA development headers, and Clang/libclang.

cargo build --locked --release --target x86_64-pc-windows-msvc -p hoshizukimio-mio-pager-bin
.\target\x86_64-pc-windows-msvc\release\mio.exe --version
cargo build --locked --release --target x86_64-unknown-linux-gnu -p hoshizukimio-mio-pager-bin
./target/x86_64-unknown-linux-gnu/release/mio --version

Install rg (ripgrep) on PATH for text search on Windows. To use an existing ripgrep binary for both bundling steps, set MIO_TOOLS_BUNDLE_RG_PATH and MIO_SHELL_BUNDLE_RG_PATH to its absolute path.

Configure your model

Create ~/.mio/config.toml (or $MIO_HOME/config.toml). Replace the model ID and URL with values from your provider.

[models]
default = "coding"

[model.coding]
model = "your-model-id"
base_url = "https://your-provider.example/v1"
api_backend = "chat_completions"
env_key = "MIO_API_KEY"

Set MIO_API_KEY in the environment if the provider requires a credential. For a keyless local provider, omit env_key. Supported api_backend values are chat_completions, responses, and messages. Model configuration covers shared providers, additional headers, and model selection.

mio models
mio
mio -p "Summarize this project"

User guide

Verify

Run python tests/smoke.py <path-to-mio> --tui against the built executable. The test uses local mock endpoints and a temporary MIO_HOME. Windows TUI verification uses pywinpty.

Source and license

mio-code is a modified fork of Grok Build, originally developed by SpaceXAI. SOURCE_REV records the upstream monorepo revision. See LICENSE, THIRD-PARTY-NOTICES, and third_party/NOTICE for licenses and attribution.

Description
Terminal coding assistant maintained by HoshizukiMio with configurable model providers.
Readme Apache-2.0 111 MiB
2026-11-19 11:02:16 +00:00
Languages
Rust 98.4%
Swift 0.8%
Kotlin 0.4%
Python 0.2%