Skip to content

0.4.0

Choose a tag to compare

@github-actions github-actions released this 26 Sep 12:05
· 12 commits to main since this release
17b10b0

Motifcode 0.4.0 brings Motif-3 into the existing MCP, Claude Code and Codex skill ecosystem, with connection management, reviewed installation and a more useful terminal interface. This release combines maintainer-authored work in #36 and #37.

MCP connections

  • Connect stdio, Streamable HTTP and legacy SSE servers through a bounded adapter that preserves Motif-3's canonical tool list. It validates server arguments, limits results, supports cancellation, backs off failed startups and blocks uncertain writes from automatic replay. Interactive sessions ask before an identical retry; one-shot runs continue to refuse it.
  • Manage servers with motif mcp add, connect, login, logout, doctor, enable, disable and remove, or browse and connect from /mcp in the terminal.
  • Eight available presets: Context7, GitHub, Playwright, Filesystem, Hugging Face, OpenAI Docs, Tauri and Gmail. Presets require explicit setup; Filesystem asks for a directory, Tauri requires its application bridge, and Gmail remains a conditional preview with separate enrollment/token setup.
  • Standard MCP OAuth supports browser authorization, refresh and --no-browser login from an interactive terminal, including SSH. Unattended non-TTY login is refused. GitHub can reuse GitHub CLI's saved account across Motif processes after explicit delegation; tokens are not copied into MCP configuration or model context.
  • Claude/Codex MCP configuration imports preview changes without writing; explicit --write creates disabled entries without copying inline secrets. Project configurations require explicit trust in the reviewed contents.

Skills and plugins

  • Install or import compatible Claude Code and Codex skills, including YAML metadata, arguments, invocation policies and supporting resources. Managed snapshots preserve source receipts and support update/removal in user or project scope.
  • Use motif skills add|import|marketplace|installed|update|remove and motif plugins add|inspect|connect to inspect packages and connect supported bundled MCP services.
  • Built-in mcp-setup, skill-setup and plugin-setup guidance supports clear Korean and English setup requests. Five workflow bundles add six skills for library documentation, browser testing, GitHub work, frontend quality, React composition and MCP building.
  • Compatibility applies to supported skill files and MCP definitions. Other hosts' hooks, agents, private connectors and credentials are not activated or transferred; unsupported features are diagnosed explicitly.

Terminal and sessions

  • /config, /status, /stats and /usage show settings, session readings and supported Infron billing information. Settings can be changed and persisted from the terminal.
  • Compact tool output keeps the conversation readable; Ctrl+O opens the full transcript. Activity feedback and command styling have been improved.
  • Interrupted one-shot runs use meaningful signal exit codes and remain resumable when safe. Resuming selects the recorded tool set and validates prompt/tool compatibility; runs interrupted during a command remain guarded.
  • Integration fixes keep dashboard, MCP, approval and masked-input panels working together. GitHub's manual device login now honors --no-browser.

Upgrade

npm install -g motifcode@0.4.0
motif version

Requires Node.js 20.3 or later. Restart existing Motif sessions after upgrading or installing new skills; preset setup within /mcp applies immediately.

Resume compatibility: an interrupted 0.3.4 journal cannot be continued with motif resume FILE on 0.4.0 because the recorded tool schema differs. Journal files are preserved. Finish interrupted work with 0.3.4 before upgrading, or start a new session on 0.4.0.

Validation and follow-up

The integrated release passed type checking, build, tool-schema lint and 1,636 tests across 94 files. CI additionally checks Node 20/22, Linux ARM64, Python and generated goldens. Real PTY terminal checks cover the combined dashboard and MCP interface.

The larger skills and MCP roadmaps (#22 and #23) remain open for their remaining acceptance criteria. Existing permission/cancellation follow-ups (#15–#17) are not claimed as resolved by this release.

Please report interoperability problems and regressions with your Motifcode version, operating system, server or skill/package version, and a minimal reproduction. Omit credentials from reports.

MCP documentation · Skills documentation · Report an issue · Full changelog