jmagly

Kintsugi Usb — AI skill for Claude Code

AI community

AI-assisted rescue boot USB — a Ventoy multi-boot drive on Ubuntu 24.04 with offline LLM inference (Ollama + llama.cpp), pre-installed agentic CLIs (Claude Code, Codex, OpenCode, Copilot, OpenClaw, om.

How to install Kintsugi Usb

This entry records only its repository, not the path inside it, so there is no exact command to give. Open jmagly/kintsugi-usb and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Kintsugi Usb does

AI-assisted rescue boot USB — a Ventoy multi-boot drive on Ubuntu 24.04 with offline LLM inference (Ollama + llama.cpp), pre-installed agentic CLIs (Claude Code, Codex, OpenCode, Copilot, OpenClaw, omnius, Aider), rescue ISOs, and a one-command build wizard.

Alternatives in AI

  • Repomix — 📦 Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file 22.7k ★
  • Autoskills — One command. Your entire AI skill stack 6.8k ★
  • Inference Serving — ai-research-skills vLLM, SGLang, TensorRT-LLM, llama.cpp 5.4k ★

README

Kintsugi USB

**Rescue your fleet. Honor the break.**

AI-assisted rescue boot media for broken systems. A Ventoy multi-boot USB on Xubuntu Minimal 24.04 (XFCE, with persistence) carrying rescue ISOs, an **offline LLM stack** (Ollama + llama.cpp), **eight pre-installed agentic CLIs**, and host-specific recovery runbooks ready to hand to an AI agent — built from a fresh clone with one command.

./scripts/kintsugi-build        # fresh clone + blank USB → a flashable, personalized .img.zst

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE) [![Version](https://img.shields.io/badge/version-2026.6.0-brightgreen?style=flat-square)](CHANGELOG.md) [![Boot](https://img.shields.io/badge/boot-UEFI%20%2B%20BIOS-brightgreen?style=flat-square)](#whats-on-it) [![Base](https://img.shields.io/badge/base-Xubuntu%20Minimal%2024.04-0E63B6?style=flat-square&logo=ubuntu&logoColor=white)](#whats-on-it) [![Offline AI](https://img.shields.io/badge/offline%20AI-Ollama%20%2B%20llama.cpp-blueviolet?style=flat-square)](#whats-on-it)

[![Built With AIWG](https://aiwg.io/assets/badges/built-with-aiwg-dark.png)](https://aiwg.io)

[**What's on it**](#whats-on-it) · [**Quick Start**](#quick-start-for-recipients) · [**Build Your Own**](#build-your-own) · [**Documentation**](#documentation) · [**Issues**](#issues)


What Kintsugi USB Is

A "final level of recovery" for home-lab and small-fleet operators: **one USB that works whether the internet is up or down, whether you know what's broken or not, and whether the person holding it built the fleet or not.** It boots almost any UEFI or BIOS machine into a lightweight Xubuntu (XFCE) desktop with rescue tooling and a local AI assistant that can read host-specific runbooks and help drive the repair.

This repo is also the **toolkit** that produces the drive: a wizard remasters a stock Xubuntu Minimal ISO into a personalized, flashable image. Fork it to roll you