Skip to content

Repository files navigation

Mithraeum — tools for the inner chamber

Tools for the inner chamber. Quiet software for people who write code by hand.

site org GPL-3.0 MMXXVI


—— I ——

Suite

I hako-edit
箱 · the box · hake
Modal text editor in a single C file. Vim-bound, language-aware, 19 themes. :rei answers from inside. latest hako-edit tag
II hako-code
箱 · the agent · hako
Standalone terminal AI agent. Same C99 stack. 13+ providers, persistent sessions, sha-verified self-update. latest hako-code tag
III hako
· in officina · hakm
Local models for the cursor on a from-scratch C engine. hako-sho (3B) + hako-koi (7B) live on HuggingFace; larger fine-tunes queued. latest hako tag
IV hako-studio
箱 · in a browser · hako.mithraeum.studio
The same agent, compiled to WebAssembly, in a tab. Static page, no backend; also served by hako --serve. latest hako-studio tag
V skills
箱 · behaviors
Markdown skills in the open Agent Skills format, for the whole suite and any agent that reads them. PR-driven catalog. pre-1.0

—— II ——

Install

hako · the agent

curl -fsSL https://mithraeums.github.io/hako.sh | sh

hake · the editor

curl -fsSL https://mithraeums.github.io/hake.sh | sh

hakm · the engine — native C, no ollama, no llama.cpp

curl -fsSL https://mithraeums.github.io/hakm.sh | sh
hakm pull hako-sho        # 3B weights from huggingface.co/mithraeum

all three

curl -fsSL https://mithraeums.github.io/install.sh | sh

Where there is no release binary — iSh is 32-bit x86 — each installer builds from source.

macOS universal2  ·  Linux x86_64 / arm64  ·  FreeBSD x86_64  ·  Windows MinGW  ·  iSh (source build)

—— III ——

Motive

I · Local first.
Your text, your keys, your weights. No telemetry. No silent network. The cursor is a private place.
II · Single binary.
One file. One C source. No JavaScript runtime to swallow your editor. The tool fits in a head.
III · Bring your own model.
Any model. Any provider. Any prompt. The agent is a peer at your terminal, not a stranger in the cloud.

—— IV ——

Site

index.html is the whole interactive site — one hand-written static file: inline CSS, inline vanilla JS, no build step, no framework, no third-party script, no web font, no tracker. It's a pane-switcher (terminal home view; nav tabs slide between Suite / Install / Skills / Releases).

One source of truth. A single MITH object at the top of index.html holds every version, repo URL, the product copy, releases, and skills. Everything dynamic renders from it — bump a version there, once. The badges in this README read the repos' own tags, so they need no edit either.

Plain mirror. html/index.html is a generated, JavaScript-free mirror for emacs eww, lynx/w3m, screen readers, and offline reading — live at /html. Do not hand-edit it:

node tools/build-mirror.mjs    # reads MITH out of index.html, rewrites html/index.html

.github/workflows/mirror.yml runs this on every push that touches index.html, so the mirror can't go stale. Custom domain mithraeum.studio points at this same Pages site, so /html is served on both.

install.sh is the suite installer (a menu, or --all / --hako / --hake / --hakm), and uninstall.sh its reverse. hake.sh / hako.sh / hakm.sh are one-line proxies to each repo's own install.sh, so a short URL never goes stale. Banner SVGs in assets/ are referenced by every project README.

— SEE LICENSE —  ·  GPL-3.0  ·  copyleft

— deus sol invictus mithras —

Releases

Packages

Used by

Contributors

Languages