Skip to content

v0.2.0

Choose a tag to compare

@github-actions github-actions released this 17 Jul 03:55

v0.2.0 — LunaMoth is now OpenCharaAgent

The project has a new name and a new home: OpenChara/OpenCharaAgent. Same runtime, same philosophy — the name now says what it is, and the moth stays as our sigil.

What changed

  • Repo: Lunamos/LunaMothOpenChara/OpenCharaAgent. GitHub redirects every old URL (clones, the installer, the in-app updater all keep working).
  • Command: the CLI is now chara (chara, chara tui, chara desktop --daemon, …). The old lunamoth command remains as a deprecated alias for one release cycle, so existing scripts and systemd units keep working.
  • Data dir: ~/.lunamoth~/.chara. Migration is automatic on first run (a symlink is left at the old path so anything not yet restarted keeps resolving). Explicit LUNAMOTH_HOME-style env pins are honoured as-is.
  • Env vars: LUNAMOTH_*CHARA_*. Every legacy LUNAMOTH_* variable is still read as a fallback — no deployment change required.
  • Package: the wheel/distribution is opencharaagent; the import package is chara.

Upgrading an existing install

The in-app update button on an old install will fail on this release (the distribution name changed under it) and will hand you the manual command — which is simply the installer again:

curl -fsSL https://raw.githubusercontent.com/OpenChara/OpenCharaAgent/main/install.sh | bash

That migrates your data dir, retires the old tool registration, and installs chara. Your charas, cards, keys and sessions all carry over untouched. Restart any running daemon afterwards (chara daemon stop && chara desktop --daemon).

Unchanged

  • Card format (SillyTavern V2/V3) and all existing cards — including each living chara's frozen card. The extensions.lunamoth card namespace is still read everywhere it was before.
  • The protocol, the gateway surface, your session data.