YukiShell is a high-performance, custom C-based Linux shell environment engineered specifically for Electronics and Communication Engineering (ECE) workflows, embedded systems development, and hardware-accelerated terminal operations.
Developed by Yukino Labs, it bridges the gap between low-level system execution, bare-metal hardware telemetry, and integrated neural workflows natively within the terminal.
Real-time querying and system hardware diagnostics.
Root-level system override initiating an isolated, RAM-only /tmp container environment.
YukiShell is packed with native C-builtins and extended Python hardware hooks to streamline complex engineering tasks.
xls— Enhanced directory lister featuring rich metadata, sizing, and custom color-coded outputs.xcat <file>— Secure file stream with custom formatting headers, replacing standardcat.cd <path>— Robust directory traversal supporting relative paths,.., and~expansion.clear— Wipes the terminal buffer and re-renders the YukiShell HUD cleanly.neofetch— Instantly displays the Yuki ASCII logo, system resource usage, and live hardware specifications.
ghostmode— Drops the user into an ephemeral, isolated namespace container. All files written inside exist only in RAM and vanish entirely upon exit.jobs— Monitors all background process IDs operating in the "Shadow Realm".xnet [host]— Lightning-fast asynchronous port scanner (100ms timeout per port) for local network auditing.dash— Launches a real-time hardware telemetry dashboard for system oversight.<command> &— Appending&detaches any process to background execution seamlessly.
ask --gemini "prompt"— Directly queries the integrated LLM for ECE coding assistance, kernel debugging, or algorithmic logic.ask --plot <port>— Yuki Oscilloscope: Reads raw serial data (e.g., from/dev/ttyUSB0at 9600 baud) and renders a live ANSI-based waveform graph directly in the terminal.ask --chip— Silicon Scanner: Activates the webcam, utilizes computer vision to read laser-etched IC markings, and fetches datasheet summaries and ASCII pinout diagrams automatically.ask --live— Visual Tutor: Initiates a real-time continuous video stream analysis agent.ask --voice— Parses acoustic input into executable terminal commands or text queries.
Who is this for?
- Embedded Software Engineers: Professionals requiring instant, scriptable access to serial ports and I2C/SPI buses without leaving the command line.
- ECE Students & Researchers: Academics who need rapid access to IC datasheets, pinout visualization, and algorithmic assistance.
- Linux Power Users: Enthusiasts looking for a lightweight, highly customized shell capable of deploying ephemeral memory containers (
ghostmode).
What makes it unique?
Unlike standard bash or zsh, YukiShell is domain-specific. It merges standard POSIX shell capabilities with bare-metal hardware analysis tools (like terminal oscilloscopes) and OpenCV-driven silicon scanning, creating an all-in-one workspace for hardware developers.
- Aegis-Edge Core Architecture: Fully modularized C source code (
builtins.c,parser.c,executor.c) for superior memory management and linker efficiency. - Baud Rate Synchronization: Hardened native 9600/115200 serial communication handling for zero-latency telemetry plotting.
- Shadow Realm Expansion: Improved PID tracking for background tasks and robust signal handling (SIGINT/Ctrl+C routing).
The diagram below maps the execution flow of YukiShell. It supports panning and zooming in compatible markdown environments.
graph TD
A([User Terminal Input]) --> B[Lexical Parser]
B --> C{Is C-Builtin?}
C -->|Yes| D[Native C Executor]
D --> D1[Filesystem: xls, xcat, cd]
D --> D2[System: ghostmode, xnet]
D --> D3[Shadow Realm: jobs, &]
C -->|No: 'ask' Hook?| E{Hardware/Neural Bridge}
E -->|No| F[Fork & Exec: /bin/]
E -->|Yes| G[yuki_ai.py Virtual Env]
G -->|--plot| H((PySerial: /dev/tty*))
G -->|--chip / --live| I((OpenCV Camera Stream))
G -->|--gemini| J((LLM Cloud API))
H --> K([Render to Yuki HUD])
I --> K
J --> K
Ensure your Linux distribution has gcc, core build utilities, and Python 3 installed.
sudo apt update
sudo apt install build-essential libreadline-dev python3 python3-venv python3-pipgit clone [https://github.com/yourusername/Yukishell.git](https://github.com/yourusername/Yukishell.git)
cd YukishellThe AI and Hardware components require specific dependencies.
python3 -m venv venv
source venv/bin/activate
pip install google-generativeai opencv-python pyserialCreate a .env file in the root directory to authorize the neural engine:
GEMINI_API_KEY=your_api_key_hereBuild the C-binaries utilizing the included headers:
gcc src/*.c -Iinclude -o yukishell -lreadline./yukishellYukiShell now includes a minimal Electron desktop app in desktop/. It wraps the native C core in a polished PTY-backed terminal window with clean chrome, branded icons, and packaging scripts for macOS, Linux, and Windows.
cd desktop
npm install
npm run devnpm run dist:mac
npm run dist:linux
npm run dist:winmacOS and Linux package the current POSIX core directly. Windows packaging ships the desktop UI and uses yukishell.exe when a native Windows core is provided; otherwise it attempts to use WSL and then falls back to the system shell. A full native Windows shell core requires a dedicated port away from POSIX-only APIs such as fork, termios, readline, /proc, and Linux namespaces.
The desktop app does not bundle .env secrets into public release artifacts. Put API keys in one of these local-only files:
~/.yukishell/.env
# or on macOS
~/Library/Application Support/YukiShell/.envGitHub release builds are handled by .github/workflows/release.yml. Push a tag such as v26d.0 to build macOS, Linux, and Windows artifacts and attach them to a GitHub Release automatically.
YukiShell thrives on community input, specifically from developers in the hardware, embedded systems, and Linux kernel spaces.
- Fork the Repository
- Branch for Features:
git checkout -b feature/NewHardwareHook - Commit cleanly:
git commit -m 'Added native I2C bus scanning builtin' - Push to branch:
git push origin feature/NewHardwareHook - Open a Pull Request: Ensure your code passes all native
gcccompilation checks without warnings.
Development Standards:
- Core shell execution, parsers, and filesystem commands must remain strictly in standard C inside the
src/directory. - External API calls and complex hardware libraries (OpenCV, PySerial) should be routed through the Python bridge to maintain C-core stability.
- Validate memory safety using
valgrindbefore submitting a PR.
Only V26c (Aegis-Edge) and newer releases receive active vulnerability monitoring and patches. Legacy V16.0 branches are deprecated.
If you discover a vulnerability—such as a namespace escape vector in ghostmode, buffer overflows in the xcat parser, or unauthorized execution contexts—please do not open a public issue.
Submit a detailed report to the Yukino Labs Security Team via private email. Ensure your report includes:
- Steps to reproduce the exploit.
- OS environment (e.g., Ubuntu 25.10, VMware).
- Severity assessment (e.g., Privilege Escalation, Arbitrary Code Execution).
We commit to addressing and patching reported vulnerabilities prior to public disclosure.
This project is distributed under the MIT License. See the LICENSE file for full details.
Designed and Developed by Aman Kumar | ECE Core | Yukino Labs