KC DevKit

Comprehensive VS Code / Cursor developer toolkit: Enhanced Markdown preview, PDF preview (CJK + math fonts), Excel/CSV preview, PowerPoint preview (ppt/pptx), code formatting, Python cache cleaner, and SageMath support.

Features

📐 Markdown Ultra Preview

Enhanced Markdown preview with math, diagrams, line numbers, and TOC navigation.

📄 PDF Preview (CJK + math fonts)

Custom editor powered by pdf.js (canvas glyph rendering — not a text-layer-only viewer).

• CJK: packed cmaps so Chinese/Japanese/Korean glyphs paint correctly
• Math / Type1: standard_fonts for embedded-standard and math fonts
• Toolbar: prev/next, zoom +/−, fit-width, fit-page, page indicator
• Keyboard: PageUp / PageDown, + / −
• Large files: only nearby pages (viewport ±1) keep canvases; offscreen canvases are destroyed
• Reloads when the PDF file changes on disk
• Errors (missing file, encrypted PDF, invalid PDF, worker failure) show in the webview and the KC DevKit output channel

*.pdf is associated with kcDevKit.pdfPreview by default (workbench.editorAssociations).

📊 Excel / CSV Preview

Custom read-only editor so Cursor can open .xlsx / .xlsm / .xls / .csv instead of showing a binary/hex dump.

• xlsx/xlsm: ExcelJS (MIT) — multiple sheets, freeze panes, column widths, wrap text, fills, cached formula values
• xls: SheetJS Community 0.18.5 (Apache-2.0)
• csv: UTF-8 / UTF-16LE with RFC 4180-style quotes
• Toolbar search filters rows; sheet tabs at the bottom; formula cells show cached results with the formula in the tooltip
• Files are not rewritten on preview, so COUNTIF/SUM, yellow input cells, and data validation stay intact

*.xlsx / *.xlsm / *.xls / *.csv associate with kcDevKit.excelPreview by default. Use Open With… to switch back to the text editor for CSV.

📊 PowerPoint Preview

Custom read-only editor so Cursor can open .pptx and .ppt instead of a binary dump.

• pptx: OOXML slides rendered in a webview (shape position, fill, text)
• ppt: converted with Microsoft PowerPoint on the machine, then rendered the same way
• Previous / next page controls; the file is not rewritten

*.pptx / *.ppt associate with kcDevKit.pptPreview by default.

🎨 Code Beautify

Multi-language formatting powered by js-beautify.

• Languages: JavaScript, TypeScript, JSON, JSONC, CSS, SCSS, LESS, HTML
• Config Chain: VS Code settings → .jsbeautifyrc (directory walk-up)
• Commands: Format Document, Format Selection
• Schema: JSON schema validation for .jsbeautifyrc files

🧹 Pycache Cleaner

One-click cleanup of Python cache artifacts.

• Recursive __pycache__/ directory removal
• .pyc / .pyo file deletion
• Optional auto-clean on workspace open
• Status bar feedback with directory count

🔮 SageMath Support

Full IDE support for SageMath mathematical software.

• Syntax Highlighting: 120+ SageMath builtins, rings, plotting, algebra, crypto
• 28 Snippets: Common patterns — polynomial rings, matrices, EC curves, plots
• Run .sage Files: Execute via terminal with configurable Sage path
• WSL Integration: Auto-detect and route to WSL Sage on Windows
• Auto-cleanup: Optional deletion of .sage.py intermediary files

Commands

Configuration

All settings are under kcDevKit.* in VS Code settings.

Markdown

Beautify

Pycache

SageMath

PDF Preview

Excel Preview

PPT Preview

Getting Started

Install from Marketplace

Search "KC DevKit" in the VS Code Extensions panel, or run:

code --install-extension kn1ghtc.kc-devkit

Install in Cursor

Prefer the repo deploy script (finds cursor.cmd / Cursor.exe, falls back to unzipping the VSIX):

powershell -ExecutionPolicy Bypass -File scripts/deploy.ps1

Or, if the Cursor CLI is on PATH:

cursor --install-extension .\kc-devkit-1.3.0.vsix --force

After install, reload the window: Developer: Reload Window.

Build from Source

git clone https://github.com/kn1ghtc/kc-devkit.git
cd kc-devkit
npm install
powershell -ExecutionPolicy Bypass -File scripts/build.ps1

Package & Deploy

powershell -ExecutionPolicy Bypass -File scripts/deploy.ps1

Local deploy never publishes. To also push to the VS Code Marketplace:

powershell -ExecutionPolicy Bypass -File scripts/deploy.ps1 -Publish

Requires AZURE_PAT in .env (walk-up discovery) for the VS Code Marketplace, and OPENVSX_TOKEN (or OVSX_PAT) for Open VSX / Cursor.

PDF smoke test (CJK text + optional PNG):

npm run smoke:pdf
# or: node scripts/smoke-pdf.mjs "D:\path\to\file.pdf"

Excel smoke test (sheet names + CJK + formulas + HTML evidence):

npm run smoke:excel
# or: node scripts/smoke-excel.mjs "D:\path\to\file.xlsx"

Requirements

• VS Code ≥ 1.80.0
• Node.js ≥ 18 (for building)
• SageMath (optional, for .sage file execution)
• WSL (optional, for SageMath on Windows)

License

MIT © kn1ghtc

Sponsor

Support research via GitHub Sponsors: $10/month read-only kctsb, $50/month also read-only NetPenetration. Sponsors may appear as avatars; they cannot push. See SPONSORS.md.