Kaze Serial

A modern serial terminal with advanced, yet easy, on the fly, highlighting features !

Kaze Serial is a modern, high-performance serial terminal application built with Tauri, Next.js, and React. It provides a sleek interface for monitoring serial ports, with advanced log exploration features

Features

• Serial Connectivity:
  • Automatic detection of available serial ports.
  • Configurable baud rates (9600 to 921600).
• High-Performance Logging:
  • Virtualized log list (using react-window) to handle large amounts of data efficiently.
  • Auto-scroll with pause-on-hover/scroll-up capability.
  • Clicking on a row of focus view will scroll the main log view to this element
• Advanced Analysis:
  • Highlighting: Define custom search patterns to highlight specific log messages with custom colors. Patterns can be:
    • Simple search
    • Case sensitive search
    • Regexp search
    • Entire line selection
  • Split View: A secondary "Focus" terminal to isolate matched logs or view different parts of the stream.
  • Sentence removal: Remove garbage by sentence matching
• Export/import:
  • export:
    • Export raw log (without highligh and sentence removal applied) to a file
    • Export the patterns for future use
  • import:
    • Re-import previous log file
    • Re-import previous patterns
• AI agent access (MCP): Expose the live log buffer to an AI agent over an embedded MCP server, so it can read the same lines you see while you debug. See AI agent access (MCP).
• Cross-Platform: Runs on Linux and windows, not tested so far on macOS (powered by Tauri).

Tech Stack

• Frontend: Next.js (React), TypeScript, Material UI.
• Backend: Tauri (Rust) for system interaction and serial port management.
• State Management: React Hooks + Tauri Commands.

Getting Started

Prerequisites

• Node.js (v18+ recommended)
• Rust (latest stable) & Cargo
• System dependencies for Tauri (see Tauri Prerequisites)

Installation

1. Clone the repository:

   git clone https://github.com/simon0356/KazeSerial.git
   cd KazeSerial

2. Install frontend dependencies:

   npm i @tauri-apps/cli
   npm install

Development

To run the application in development mode (with hot-reloading for both frontend and Rust backend):

npm run tauri dev

Build

To build the application for production:

npm run tauri build

The output binary/installer will be located in src-tauri/target/release/bundle/.

AI agent access (MCP)

Kaze Serial can expose its log buffer to an AI coding agent through an MCP server embedded in the app. The agent reads the same buffer you are looking at, so you can ask it to dig through a capture while you keep reproducing the bug.

Enabling it

Click the 🤖 button in the log toolbar. The server binds to loopback only and the app prints its URL into the log:

[09:03:25] KazeSerial: MCP server listening on http://127.0.0.1:9339/mcp

Then register it with your agent — for Claude Code:

claude mcp add --transport http kazeserial http://127.0.0.1:9339/mcp

To start the server automatically at launch instead of clicking, set KAZESERIAL_MCP_PORT (use 0 to let the OS pick a free port):

KAZESERIAL_MCP_PORT=9339 kazeserial

Tools

Tool	Purpose
get_status	Log source, line count, oldest/newest line id. The orientation call — its ids are the cursors the other tools take.
tail_logs	The most recent lines, like tail -n.
search_logs	Substring or regex search with optional context lines. The cheapest way into a large capture.
get_logs_range	Every line between two ids, to zoom in around a hit.
get_focus_logs	Only the lines your own "focus" highlight rules matched — high signal.
get_all_logs	The complete buffer, paginated.
wait_for_logs	Blocks until lines newer than a given id arrive, so the agent can follow a live capture without polling.
clear_logs	Clears the buffer in both the agent's view and your window. The only tool that writes anything.

Line text is always the raw line, with no highlight markup. Nothing in this interface can write to the serial port.

Notes

• The buffer is a ring of 500 000 lines; override with KAZESERIAL_LOG_CAPACITY. get_status reports how many lines have been evicted.
• The server listens on 127.0.0.1 only, and validates the Host header against loopback names. Any other local process can still read your logs while it is running, so leave it off when you do not need it.

Configuration

• Highlights: Highlight settings are automatically saved to highlight_settings.json in the application configuration directory.
• MCP server: Off by default. KAZESERIAL_MCP_PORT starts it at launch; KAZESERIAL_LOG_CAPACITY sets the number of lines kept in memory.

Background

Since I work as an embedded software developper, most of my work time consist of looking on serial monitor for debug purpose. I used to work a lot with minicom and more recently with Serial Monitor Rust. Highlight features on Serial Monitor Rust was not his main purpose and i'm not so confident with EGUI framework.
Since I wanted to learn React, i did this simple project, and of course Copilot and LLM agent help me a lot for bootstraping this project

License

MIT

Contributor :

JackHerRrer