Skip to content

Moryn v0.1

Choose a tag to compare

View all tags
@Richardyu114 Richardyu114 released this 16 Jun 07:00
· 276 commits to main since this release
v0.1
773cd3a

Moryn v0.1

First public MVP release of Moryn, a local-first memory, skill, and handoff layer
for AI agents.

Install

npm install -g @richardyu114/moryn@0.1.0

The primary executable is moryn. The package also includes
moryn-agent-smoke for post-install lifecycle smoke testing.

Highlights

  • Local-first agent memory store under ~/.moryn.
  • Append-only event history with rebuildable snapshots and indexes.
  • Record model for memory, skill, soul, session_summary, and
    agent_note.
  • Safety states for raw, candidate, canonical, archived, and
    quarantined records.
  • CLI access for initialization, writes, recall, boot, refresh, revision,
    promotion, archive, quarantine, linking, rebuild, and Git sync.
  • stdio MCP server so Codex, Claude, Cursor, Gemini, and other MCP hosts can use
    the same local store.
  • Agent lifecycle commands for startup guidance, status checkpoints, and final
    handoff summaries.
  • Operation contracts and selection-source contracts so agents can discover the
    command surface instead of relying on hard-coded README examples.
  • Optional Git sync to a user-owned private repository. Event history is the
    source of truth; derived local views are intentionally rebuildable.

Agent Workflow

Moryn is designed for agents to operate directly. The intended setup flow is:

moryn init
moryn project init --path <repo>
moryn agent guide
moryn contracts operations --index

Agents can then recall project context, write durable decisions, share
in-progress status, and finish with a handoff summary for the next session.

MCP

Start the MCP server with:

moryn mcp

Generic MCP host configuration:

{
  "mcpServers": {
    "moryn": {
      "command": "moryn",
      "args": ["mcp"]
    }
  }
}

Verification

This release was prepared with the project release gate:

npm run release:check
npm run smoke:agent-lifecycle

The npm package maps to Git commit:

773cd3a88729b176bf652c733573ba585d374f5b

The GitHub tag v0.1 points to the same commit.

Known Limits

  • This is a first-version MVP.
  • Sync uses Git and is intended for a dedicated private Moryn data repository,
    not the source code repository.
  • Dashboard observability is not part of this release; it arrives in v0.1.1.
  • The CLI version string in this release is static.
Assets 2
Loading