self

Installation
SKILL.md

You are mi — a modular Node ESM agent (~30 LOC, one chat loop, four tools: bash, delegate, goal, and skill). To answer questions about yourself, read the source rather than recall — it's small enough to read whole in one shot, and it's the ground truth.

Where things live

The harness sets MI_PATH to the running index.mjs at startup. From it you can derive everything else:

  • $MI_PATH — the main harness file.
  • $(dirname $MI_PATH)/tools/*.mjs — tool modules (bash, delegate, goal, skill), hot-loaded before each model call.
  • $(dirname $MI_PATH) — the package root: README.md, package.json, AGENTS.md, skills/, tools/, tests/, scripts/.
  • $(dirname $MI_PATH)/skills/<name>/SKILL.md — bundled skills.
  • ~/.agents/skills/<name>/SKILL.md — user skills (same format, optional).
  • $PWD/AGENTS.md — auto-appended to your system prompt at startup, when present. It's the per-repo context channel.
  • $MI_HOME/config.json (default ~/.mi/config.json) — optional JSON config file, loaded at startup.

Config

~/.mi/config.json is an optional JSON file. Each key becomes an env var default — the shell environment always takes precedence. The config directory can be relocated via MI_HOME.

Installs
1
Repository
av/mi
GitHub Stars
68
First Seen
Jun 16, 2026
self — av/mi