distilly

Overview

Distilly is a local-first CLI that turns a person's source material, working habits, judgment, and voice into a versioned Person Profile for AI agents. Profiles can be recalled temporarily during a run or installed as long-lived host skills for Codex, OpenClaw, Hermes, and Claude Code. It exposes five MCP tools, keeps all data local, and requires no extra model API key.

README Preview

\n\n\n\n\n\n# Distilly\n\n### Distill how they think into Person Profiles for Agents.\n\n**Colleague Skill / colleague-skill (original name)**\n\n[](LICENSE)\n[](https://nodejs.org/)\n[](https://github.com/titanwings/distilly/tree/distilly-plugin)\n\n\n\nDistilly is a local-first product for turning a person's source material, working habits, judgment, and voice into a versioned **Person Profile for Agents**. The profile can be recalled temporarily during a run or explicitly installed as a long-lived host Skill. The storage authority stays local; no additional model API key is required.\n\nThis repository now defaults to the unreleased `0.1.0-preview.1` Developer Preview on `distilly-plugin`. Codex, OpenClaw `2026.3.24`, and Hermes `v0.9.0` each have an immutable real-host transport-capacity fixture. The OpenClaw and Hermes measurements use a deterministic synthetic fixture server through the real host executable, model, and MCP transport; they do not by themselves certify packaged restart or the full product lifecycle. Setup remains fail-closed for any unrecorded host version or changed release tuple. It is the default GitHub branch, but it is not a tagged release or an npm package yet.\n\n[Chinese](docs/lang/README_ZH.md) · [Español](docs/lang/README_ES.md) · [Deutsch](docs/lang/README_DE.md) · [日本語](docs/lang/README_JA.md) · [한국어](docs/lang/README_KO.md) · [Português](docs/lang/README_PT.md) · [Русский](docs/lang/README_RU.md)\n\n## Install the Developer Preview\n\n### For an agent\n\nGive your coding agent the following task and let it run the commands in a fresh checkout:\n\n> Install the Distilly Developer Preview from the `distilly-plugin` branch, build it with Node 22.19+ (or Node 24), run `distilly setup --host codex`, run `distilly doctor --host codex`, and report the result. Do not modify another branch.\n\nThe exact checkout and setup commands are shown below so the agent can verify every step.\n\n### For a human\n\nRequirements: Node.js `22.19+` or `24`