Repository navigation
0.4.0
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,disableandremove, or browse and connect from/mcpin 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-browserlogin 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
--writecreates 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|removeandmotif plugins add|inspect|connectto inspect packages and connect supported bundled MCP services. - Built-in
mcp-setup,skill-setupandplugin-setupguidance 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,/statsand/usageshow 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 versionRequires 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