{"id":49248454,"url":"https://github.com/yukicodepth/yukishell","last_synced_at":"2026-04-24T23:01:38.608Z","repository":{"id":342743146,"uuid":"1173810992","full_name":"YukiCodepth/yukishell","owner":"YukiCodepth","description":"A next-gen, AI-augmented Linux shell. Featuring autonomous LangGraph agents, persistent history, dynamic .yukirc aliases, and true-color terminal aesthetics. Built by an ECE mind at SRM.","archived":false,"fork":false,"pushed_at":"2026-04-23T07:47:56.000Z","size":1090,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-23T08:26:56.862Z","etag":null,"topics":["ai-agent","automation","c-programming","cli-tool","embedded-systems","langchain","langgraph","linux-shell","python","terminal-ui"],"latest_commit_sha":null,"homepage":"https://github.com/YukiCodepth/yukishell","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/YukiCodepth.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-05T19:22:05.000Z","updated_at":"2026-04-23T07:48:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/YukiCodepth/yukishell","commit_stats":null,"previous_names":["yukicodepth/yukishell"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/YukiCodepth/yukishell","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YukiCodepth%2Fyukishell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YukiCodepth%2Fyukishell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YukiCodepth%2Fyukishell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YukiCodepth%2Fyukishell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YukiCodepth","download_url":"https://codeload.github.com/YukiCodepth/yukishell/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YukiCodepth%2Fyukishell/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32243803,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T13:21:15.438Z","status":"ssl_error","status_checked_at":"2026-04-24T13:21:15.005Z","response_time":64,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","automation","c-programming","cli-tool","embedded-systems","langchain","langgraph","linux-shell","python","terminal-ui"],"created_at":"2026-04-24T23:01:37.674Z","updated_at":"2026-04-24T23:01:38.593Z","avatar_url":"https://github.com/YukiCodepth.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# YukiShell | (V26c)\n\n![C](https://img.shields.io/badge/C-00599C?style=for-the-badge\u0026logo=c\u0026logoColor=white)\n![Python](https://img.shields.io/badge/Python-3776AB?style=for-the-badge\u0026logo=python\u0026logoColor=white)\n![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge\u0026logo=linux\u0026logoColor=black)\n![License](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)\n\n**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.\n\nDeveloped by **Yukino Labs**, it bridges the gap between low-level system execution, bare-metal hardware telemetry, and integrated neural workflows natively within the terminal.\n\n\u003c/div\u003e\n\n---\n\n## 📸 System Interface\n\n### Integrated LLM \u0026 Environment Fetch\n*Real-time querying and system hardware diagnostics.*\n![YukiShell Core UI](assets/ai-mode.png)\n\n### Ghostmode (Ephemeral Namespace)\n*Root-level system override initiating an isolated, RAM-only `/tmp` container environment.*\n![YukiShell Ghostmode](assets/ghostmode.png)\n\n---\n\n## ⚙️ Core Features \u0026 Command Manifest\n\nYukiShell is packed with native C-builtins and extended Python hardware hooks to streamline complex engineering tasks.\n\n### 📁 Filesystem \u0026 Core\n* **`xls`** — Enhanced directory lister featuring rich metadata, sizing, and custom color-coded outputs.\n* **`xcat \u003cfile\u003e`** — Secure file stream with custom formatting headers, replacing standard `cat`.\n* **`cd \u003cpath\u003e`** — Robust directory traversal supporting relative paths, `..`, and `~` expansion.\n* **`clear`** — Wipes the terminal buffer and re-renders the YukiShell HUD cleanly.\n* **`neofetch`** — Instantly displays the Yuki ASCII logo, system resource usage, and live hardware specifications.\n\n### 🛡️ System \u0026 Network (Sentinel)\n* **`ghostmode`** — Drops the user into an ephemeral, isolated namespace container. All files written inside exist only in RAM and vanish entirely upon exit.\n* **`jobs`** — Monitors all background process IDs operating in the \"Shadow Realm\".\n* **`xnet [host]`** — Lightning-fast asynchronous port scanner (100ms timeout per port) for local network auditing.\n* **`dash`** — Launches a real-time hardware telemetry dashboard for system oversight.\n* **`\u003ccommand\u003e \u0026`** — Appending `\u0026` detaches any process to background execution seamlessly.\n\n### 🧠 Neural Link \u0026 Vision (`ask` sub-engine)\n* **`ask --gemini \"prompt\"`** — Directly queries the integrated LLM for ECE coding assistance, kernel debugging, or algorithmic logic.\n* **`ask --plot \u003cport\u003e`** — **Yuki Oscilloscope:** Reads raw serial data (e.g., from `/dev/ttyUSB0` at 9600 baud) and renders a live ANSI-based waveform graph directly in the terminal.\n* **`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.\n* **`ask --live`** — **Visual Tutor:** Initiates a real-time continuous video stream analysis agent.\n* **`ask --voice`** — Parses acoustic input into executable terminal commands or text queries.\n\n---\n\n## 🎯 Target Audience \u0026 Unique Value\n\n**Who is this for?**\n* **Embedded Software Engineers:** Professionals requiring instant, scriptable access to serial ports and I2C/SPI buses without leaving the command line.\n* **ECE Students \u0026 Researchers:** Academics who need rapid access to IC datasheets, pinout visualization, and algorithmic assistance.\n* **Linux Power Users:** Enthusiasts looking for a lightweight, highly customized shell capable of deploying ephemeral memory containers (`ghostmode`).\n\n**What makes it unique?**\nUnlike 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.\n\n---\n\n## 🆕 What's New in V26c\n* **Aegis-Edge Core Architecture:** Fully modularized C source code (`builtins.c`, `parser.c`, `executor.c`) for superior memory management and linker efficiency.\n* **Baud Rate Synchronization:** Hardened native 9600/115200 serial communication handling for zero-latency telemetry plotting.\n* **Shadow Realm Expansion:** Improved PID tracking for background tasks and robust signal handling (SIGINT/Ctrl+C routing).\n\n---\n\n## 🏗️ System Architecture \u0026 Workflow\n\n*The diagram below maps the execution flow of YukiShell. It supports panning and zooming in compatible markdown environments.*\n\n```mermaid\ngraph TD\n    A([User Terminal Input]) --\u003e B[Lexical Parser]\n    B --\u003e C{Is C-Builtin?}\n    \n    C --\u003e|Yes| D[Native C Executor]\n    D --\u003e D1[Filesystem: xls, xcat, cd]\n    D --\u003e D2[System: ghostmode, xnet]\n    D --\u003e D3[Shadow Realm: jobs, \u0026]\n    \n    C --\u003e|No: 'ask' Hook?| E{Hardware/Neural Bridge}\n    \n    E --\u003e|No| F[Fork \u0026 Exec: /bin/]\n    \n    E --\u003e|Yes| G[yuki_ai.py Virtual Env]\n    \n    G --\u003e|--plot| H((PySerial: /dev/tty*))\n    G --\u003e|--chip / --live| I((OpenCV Camera Stream))\n    G --\u003e|--gemini| J((LLM Cloud API))\n    \n    H --\u003e K([Render to Yuki HUD])\n    I --\u003e K\n    J --\u003e K\n```\n\n---\n\n## 🛠️ Installation \u0026 Setup\n\n### Prerequisites\nEnsure your Linux distribution has `gcc`, core build utilities, and Python 3 installed.\n```bash\nsudo apt update\nsudo apt install build-essential libreadline-dev python3 python3-venv python3-pip\n```\n\n### 1. Clone the Repository\n```bash\ngit clone [https://github.com/yourusername/Yukishell.git](https://github.com/yourusername/Yukishell.git)\ncd Yukishell\n```\n\n### 2. Configure the Python Environment\nThe AI and Hardware components require specific dependencies.\n```bash\npython3 -m venv venv\nsource venv/bin/activate\npip install google-generativeai opencv-python pyserial\n```\n\n### 3. API Key Configuration\nCreate a `.env` file in the root directory to authorize the neural engine:\n```env\nGEMINI_API_KEY=your_api_key_here\n```\n\n### 4. Compile the Aegis-Edge Core\nBuild the C-binaries utilizing the included headers:\n```bash\ngcc src/*.c -Iinclude -o yukishell -lreadline\n```\n\n### 5. Launch YukiShell\n```bash\n./yukishell\n```\n\n---\n\n## 🖥️ Desktop App Preview\n\nYukiShell 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.\n\n### Run the Desktop App\n```bash\ncd desktop\nnpm install\nnpm run dev\n```\n\n### Package Builds\n```bash\nnpm run dist:mac\nnpm run dist:linux\nnpm run dist:win\n```\n\nmacOS 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.\n\nThe desktop app does not bundle `.env` secrets into public release artifacts. Put API keys in one of these local-only files:\n\n```bash\n~/.yukishell/.env\n# or on macOS\n~/Library/Application Support/YukiShell/.env\n```\n\nGitHub 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.\n\n---\n\n## 🤝 Contribution Guidelines\n\nYukiShell thrives on community input, specifically from developers in the hardware, embedded systems, and Linux kernel spaces. \n\n1. **Fork the Repository**\n2. **Branch for Features:** `git checkout -b feature/NewHardwareHook`\n3. **Commit cleanly:** `git commit -m 'Added native I2C bus scanning builtin'`\n4. **Push to branch:** `git push origin feature/NewHardwareHook`\n5. **Open a Pull Request:** Ensure your code passes all native `gcc` compilation checks without warnings.\n\n**Development Standards:**\n* Core shell execution, parsers, and filesystem commands must remain strictly in standard C inside the `src/` directory.\n* External API calls and complex hardware libraries (OpenCV, PySerial) should be routed through the Python bridge to maintain C-core stability.\n* Validate memory safety using `valgrind` before submitting a PR.\n\n---\n\n## 🔒 Security Policy\n\n### Supported Versions\nOnly **V26c (Aegis-Edge)** and newer releases receive active vulnerability monitoring and patches. Legacy V16.0 branches are deprecated.\n\n### Reporting Vulnerabilities\nIf 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.\n\nSubmit a detailed report to the **Yukino Labs Security Team** via private email. Ensure your report includes:\n* Steps to reproduce the exploit.\n* OS environment (e.g., Ubuntu 25.10, VMware).\n* Severity assessment (e.g., Privilege Escalation, Arbitrary Code Execution).\n\nWe commit to addressing and patching reported vulnerabilities prior to public disclosure.\n\n---\n\n## 📜 License\n\nThis project is distributed under the **MIT License**. See the `LICENSE` file for full details.\n\n\u003e **Designed and Developed by Aman Kumar** | ECE Core | Yukino Labs \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyukicodepth%2Fyukishell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyukicodepth%2Fyukishell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyukicodepth%2Fyukishell/lists"}