Releases: mraccah2/merlin
Release list
v0.1.1 — hum + memory adoption gap closed
Patch release. No kernel API changes; all additions are docs + seed
files + a path-bug fix.
What's new since v0.1.0
docs/hum.md
Full walkthrough from "fresh clone with empty data/" to a working
hum loop. Ground-state file map, three-step seeding flow
(registry → intent → timezone), harvester schema, candidate-JSON
contract for writing your own.
docs/memory.md
Same shape for the wiki/memory layer. Five page types to seed
first (user_owner, user_daily_schedule, feedback_, project_,
reference_*), frontmatter conventions, how the pinned subset
self-tunes via wiki-audit.
examples/hum-interests.example.json
examples/hum-intent.example.md
examples/user-timezone.example.json
Seed templates. merlin init now copies these to data/ on first
run (idempotent — never clobbers existing files).
bin/merlin (init subcommand)
Now seeds the three example files into data/ after the dirs +
.env. Output points adopters at docs/hum.md + docs/memory.md.
agent/scripts/hum-harvest-all.mjs
Path-bug fix — was still hardcoding path.join(HOME, "dev/merlin/...")
from the gandalf layout. Now uses MERLIN_HOME env-var with
$HOME/Dev/merlin fallback like the rest of the tree.
README.md
"What you'll build yourself" table reorganized to lead with the
two ground-state gaps (Hum + Memory populated) and link to the
new docs.
Upgrading from v0.1.0
Pull, re-run ./bin/merlin init (it'll seed the three new example
files into data/ if they don't exist; your existing files are
left alone). No supervisor restart needed.
v0.1.0 — initial public release
A 24/7 personal-agent OS built on Claude Code. Persistent claude -p
supervisors, markdown-playbook jobs, opt-in ingress channels (webhook,
gmail-pubsub, phone-realtime, dispatch-bridge), SQLite/FTS5 memory
layer with embeddings, two SwiftUI companion apps (chat + fitness),
and a 22-tool CLI surface.
What ships
- Kernel substrate: process-manager + supervisors + MCP shell bridge
- 4 channel plugins (webhook, gmail-pubsub, phone-realtime, dispatch)
- 22 user-facing CLIs (merlin, wiki, memory, email-, hum-, …)
- 7 reference jobs (morning-digest, hum + 5 hum-* playbooks,
wiki-audit, memory-snapshot, chrome-cdp-watch, context-sync) - Hum harness + 7 generic harvesters (weather, news, calendar,
tasks, watchdog, serendipity, _common) — write your own from here - iOS/macOS companion app (Catalyst) with TestFlight CI
- iOS fitness tracker (Spotter)
- Wiki/memory store: SQLite + FTS5 + nomic-embed-text embeddings,
DB-as-truth with .md round-trip - Local-LLM ack layer via Ollama
- Outbound + memory-write LLM-gated prechecks
- macOS launchd + Linux systemd installer docs
Quickstart
git clone https://github.com/mraccah2/merlin.git ~/Dev/merlin
cd ~/Dev/merlin
./scripts/bootstrap.sh
./bin/merlin init
./bin/merlin up
./bin/merlin dispatch morning-digest
./bin/merlin tail ops
Apache 2.0. Sanitized + generalized from a personal Mac-Mini-hosted
agent that's been running 24/7. The patterns are battle-tested; the
integrations are deliberately sparse because they're the part you
have to make yours.