mistermorph

README

Mister Morph

Desktop app, CLI, and reusable Go runtime for AI agents.

Other languages: 简体中文 | 日本語

To try Mister Morph, start with the desktop App from GitHub Releases. It includes the Console UI, starts the local backend, and guides first-run setup.

Why Mister Morph

• 🖥️ App-first setup: use the desktop App to get started; use the CLI when you need a server or script.
• 🧩 Reusable Go core: run Mister Morph as an App, CLI, or Console backend, or embed it in your projects.
• 🤝 Connection: Aqua lets agents talk to each other, so multiple agents can plan and work together.
• 🛠️ Practical extensions: built-in tools, SKILL.md skills, and Go embedding cover local use and automation.
• 🔒 Security-minded: auth profiles, outbound policy, approvals, and redaction are built in.

Quick Start

Desktop App (recommended)

1. Download a release asset from the GitHub Releases page:
   • macOS: mistermorph-desktop-darwin-arm64.dmg
   • Linux: mistermorph-desktop-linux-amd64.AppImage or mistermorph-desktop-linux-amd64.deb
   • Windows: mistermorph-desktop-windows-amd64.zip
2. Open the App.
3. Use the Agent.

Build, packaging, and platform notes: docs/app.md

CLI

Install the CLI:

curl -fsSL -o /tmp/install-mistermorph.sh https://raw.githubusercontent.com/quailyquaily/mistermorph/refs/heads/master/scripts/install-release.sh
sudo bash /tmp/install-mistermorph.sh

Or install from source:

go install github.com/quailyquaily/mistermorph/cmd/mistermorph@latest

Set up a workspace, set an API key, and run one task:

mistermorph install
export MISTER_MORPH_LLM_API_KEY="YOUR_API_KEY"
mistermorph run --task "Hello!"

If config.yaml is missing, mistermorph install starts the setup wizard and writes the first workspace files.

CLI modes and configuration details: docs/modes.md, docs/configuration.md

What It Includes

• A desktop App with first-run setup and the Console UI.
• A CLI for one-shot tasks, scripts, automation, and server modes.
• A local Console server for setup, runtime management, and monitoring.
• Channel runtimes for Telegram, Slack, LINE, and Lark.
• A Go integration layer for embedding Mister Morph into other projects.
• Built-in tools and a SKILL.md-based skills system.
• Security controls for auth profiles, outbound policies, approvals, and redaction.

Documentation

Start here:

• Desktop App
• Modes
• Configuration
• Troubleshoots

Reference:

• Console
• Aqua Connection
• Tools
• Skills
• Security
• Integration
• Architecture

Channel setup:

• Telegram
• Slack
• LINE
• Lark

Full docs index: docs/README.md

Development

Useful commands:

./scripts/build-backend.sh --output ./bin/mistermorph
./scripts/build-desktop.sh --release
go test ./...

The Console frontend lives in web/console/ and uses pnpm. See docs/console.md and docs/app.md for build details.

Configuration Template

The canonical config template is assets/config/config.example.yaml. Environment variables use the MISTER_MORPH_ prefix. Full config notes and common flags are in docs/configuration.md.

Storage Compatibility

Mister Morph now uses the unified domain journal as the source of truth for memory and task/topic facts.

Legacy Console topic/task files are still read as a one-time migration path when the new projection snapshot is missing. This keeps existing workspaces usable during the transition. The migration code is planned for removal in version 0.3.

Star History