Moryn v0.1.1

Moryn v0.1.1

Patch release after the first npm publication. This release keeps the public
package on the 0.1.x line and adds a local observability dashboard for
inspecting Moryn stores during agent work.

Install

npm install -g @richardyu114/moryn@0.1.1

@richardyu114/moryn@0.1.1 is the npm latest dist-tag for the public package.

Highlights

• Adds moryn dashboard as a local observability surface.
• Supports live dashboard serving with configurable host, port, refresh interval,
  and record limit.
• Adds static dashboard snapshots for automation and MCP environments.
• Exposes dashboard JSON at /api/dashboard and a lightweight /healthz
  endpoint in server mode.
• Documents dashboard access modes, privacy behavior, and troubleshooting.
• Updates npm metadata for public package discovery: repository URL, keywords,
  homepage, bugs URL, and explicit public npm registry publishing config.
• Refines agent install documentation so agents prefer the npm package for
  normal use and use the source repo only for source development.

Dashboard

Run the live dashboard locally:

moryn dashboard --serve --host 127.0.0.1 --port 8765

Open:

http://127.0.0.1:8765/

For another device on the same LAN, bind to 0.0.0.0 and open the serving
machine's LAN address. Firewall and network policy still need to allow the port.

Static mode writes a snapshot inside the local Moryn store:

moryn dashboard --no-open

The snapshot lives under:

state/dashboard/index.html

The dashboard remains local-first. It reads the local Moryn event history and
does not upload dashboard data.

What The Dashboard Shows

• Store health and attention items.
• Sync status, ahead/behind state, and conflict signals.
• Record counts by state and type.
• Recent useful records.
• Recent raw events for debugging.
• Agent activity and lifecycle handoff visibility.

Quarantined content is redacted from overview and inspector surfaces.

Compatibility Notes

• No storage format migration is required from v0.1.
• Existing CLI and MCP memory operations continue to work.
• Dashboard snapshots are local derived artifacts and are not synced.
• The dashboard server is local HTTP; exposing it beyond 127.0.0.1 should be
  treated as sharing access to local Moryn observability data.

Verification

This release was prepared with:

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

The npm package maps to Git commit:

4a56207737defc67599d336735d5cb3a407ef07b

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

Public npm install verification for this release passed for package install and
agent lifecycle smoke. The CLI --version output still reports the static
internal version string from the original MVP code path; this release keeps the
public version line at 0.1.1 and does not introduce a 0.1.2 release.

Moryn v0.1

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.