palusc

Codebone — AI skill for Claude Code

AI community

A real-time semantic codebase knowledge graph powered by a local LLM for macOS, delivering clean architectural context to AI coding agents through native MCP.

How to install Codebone

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

What Codebone does

A real-time semantic codebase knowledge graph powered by a local LLM for macOS, delivering clean architectural context to AI coding agents through native MCP.

Alternatives in AI

  • Sentrux — Real-time architectural sensor that helps AI agents close the feedback loop, enabling recursive self-improveme 2.9k ★
  • Wiki Graph — Build the LLM Wiki knowledge graph 2.3k ★
  • Claude Usage Tracker — Native macOS menu bar app for tracking Claude AI usage limits in real-time 2.2k ★

README

🦴 codebone

Real-time codebase knowledge graph for your macOS menu bar.

**Stop dumping dozens of files into your prompt. Let the dog sniff it.** 🐾


[![macOS](https://img.shields.io/badge/platform-macOS-black?logo=apple&style=flat-square)](#) [![Metal GPU](https://img.shields.io/badge/inference-Apple%20Silicon%20Metal-purple?style=flat-square)](#) [![MCP](https://img.shields.io/badge/protocol-MCP%20Native-blue?style=flat-square)](#) [![Version 1.2.0](https://img.shields.io/badge/version-1.2.0-informational?style=flat-square)](CHANGELOG.md) [![License: MIT](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE) [![Local Only](https://img.shields.io/badge/privacy-100%25%20local-success?style=flat-square)](#-privacy--security)


📉 Why codebone?

AI assistants typically read 10–20 files just to understand your architecture — burning thousands of tokens on boilerplate before writing a single line of code.

Token overhead: Raw File Dump ~25k tokens, Vector RAG ~14k tokens, codebone ~2k tokens

codebone runs in your macOS menu bar, watches every file save, and delivers a live architectural snapshot directly to Claude, Cursor, or Gemini via MCP.


🚀 Download & Install

[⬇️ Download](https://github.com/palusc/codebone/releases/download/v1.2.0/codebone-macos-arm64.dmg)

Drag `codebone.app` to `/Applications` — done. A 🦴 appears in your menu bar.

Click it → **Select Project Folder...** to start your first scan.

💾 ~650 MB total (~390 MB model + ~260 MB venv). Requires macOS 13+ on Apple Silicon.

Homebrew / Build from Source

**Homebrew:**

brew tap palusc/codebone
brew install codebone

**Build from source:**

git clone https://github.com/palusc/codebone.git
cd codebone
./install.sh

🐾 How It Works

  1. Sniff — Watches