Skip to content

Releases: mraccah2/merlin

v0.1.1 — hum + memory adoption gap closed

Choose a tag to compare

@mraccah2 mraccah2 released this 19 May 23:53

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

Choose a tag to compare

@mraccah2 mraccah2 released this 19 May 23:45

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.