Overview

HolonCode-KIT is a literate-programming editor written in Tcl/Tk. It stores a program as a book: a structure of chapters, sections, and units (pages). Each unit holds one proc or code block. WriteAllChapters regenerates the .tcl source files from the book on every save.

HolonCode-KIT is open for use under GPLv3.

Requirements

Tcl/Tk 8.6 or later (9.x recommended). No external packages are required for the editor itself; the .hdb converter additionally needs Mk4tcl.

Download Tcl/Tk: https://www.tcl.tk/software/tcltk/

Running

Each project has a .command launcher. Pass the book file as argument:

tclsh holoncode/holoncode.tcl MyProject.kit

Or use the provided .command files:

• HolonS/holons.command — opens the HolonCode master book
• HolonTF/HolonTF.command — opens the TclForth project
• Project/Project.command — ready-to-use blank project

Content

• HolonS — the HolonCode kernel as a Holon book; regenerates the source in holoncode/
• HolonTF — a Holon application project that produces TclForth
• Project — a blank project template, ready to use
• holoncode/ — the HolonCode kernel source (canonical copy)

Data files

Books are stored as HolonKit files (.kit): the whole book held in memory and dumped to one file (see holoncode/kitio.tcl and HOST86/HOLONKIT.md). It carries four parts — base (config), pages (chapters/sections/units), archive (revision history), and oldpages (saved versions). The legacy .hdb (Metakit) books are kept alongside for reference.

Tools

• convert_db_to_kit.tcl — converts a SQLite .db book to .kit
• convert_hdb_to_kit.tcl — converts a legacy Metakit .hdb book straight to .kit (needs Mk4tcl)
• kit_tool.tcl — inspect/edit a .kit book from the shell
• migrate_book_to_kit.tcl — kernel-book migration helper (template for structural book edits)