Skillget

mosaic-companion

mcp
Security Audit
Fail
Health Pass
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 16 GitHub stars
Code Fail
  • fs.rmSync — Destructive file system operation in bundled-addons/hyperinsight/main/index.js
  • network request — Outbound network request in bundled-addons/hyperinsight/main/index.js
  • exec() — Shell command execution in electron/addon-preload.ts
  • fs.rmSync — Destructive file system operation in electron/addons/api/agents.ts
  • fs.rmSync — Destructive file system operation in electron/addons/api/files.ts
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Open desktop runtime for AI agents, tools, and integrations — MCP servers, sandboxed WASM tools, and permissioned add-ons in one workspace.

README.md

Mosaic Companion

Mosaic Companion is an open-source AI companion browser by HyperCycle. It lets you chat with AI agents from multiple providers — Claude, OpenAI, Gemini, Ollama, and HyperCycle — inside a familiar browser-style, tabbed desktop app.

Beyond chat, Mosaic includes a Vault with per-agent access controls, support for MCP tool servers, a sandboxed WASM tool runtime, Web3 wallet features, and a built-in IDE.

Mosaic Companion is pre-1.0 and under active development. Interfaces, data formats, and extension APIs may change between releases.

Download & Install

The easiest way to get Mosaic Companion is the new download home:

Installers cover all three platforms, but support differs:

Platform Format Status
macOS .dmg Works. macOS blocks the app the first time you open it. The install page has the one-time step.
Windows Setup.exe Works. SmartScreen warns on first run. The install page has the step.
Linux .deb, AppImage Published, but not in a known-good state. Expect problems, and report what you hit.

Releases aren't code-signed or notarized. The first-run warnings on macOS and
Windows come from that, not from a problem with the download.

For a full non-technical walkthrough (install, first launch, connecting your first AI provider), see the Getting Started guide.

Run from Source

For contributors and anyone who wants to build the app themselves.

Prerequisites: Node.js 20+ and npm 9+

npm install

# Renderer-only dev server (Vite, hot reload)
npm run dev

# Full Electron app (via Electron Forge)
npm start

Or run ./setup.sh for an automated setup, or ./start.sh to install dependencies (if needed) and launch the app.

There is no API-key file to set up: AI provider keys are configured inside the app, either through the onboarding wizard on first launch or later under Configuration → AI Agents.

Available Scripts

  • npm run dev - Start the Vite renderer dev server with hot reload
  • npm run build - Build the application for production
  • npm start - Start the Electron app via Forge
  • npm run preview - Preview the production build
  • npm run typecheck - Run TypeScript type checking without building
  • npm run clean - Remove build artifacts

Build & Package Scripts (Electron Forge)

Script Description
npm run make Build for current platform/arch
npm run make:linux Build Linux (native arch)
npm run make:linux:x64 Build Linux x64
npm run make:linux:arm64 Build Linux arm64
npm run make:mac Build macOS (native arch)
npm run make:mac:x64 Build macOS x64
npm run make:mac:arm64 Build macOS arm64
npm run make:win Build Windows (native arch)
npm run make:win:x64 Build Windows x64
npm run make:win:arm64 Build Windows arm64
npm run deploy Publish a release (maintainers: see docs/release-process.md)
npm run deploy:x64 Publish x64 (maintainers: see docs/release-process.md)
npm run deploy:arm64 Publish arm64 (maintainers: see docs/release-process.md)

License

Mosaic Companion is licensed under the Apache License 2.0. See NOTICE for attribution details.

Reviews (0)

No results found