JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 23
  • Score
    100M100P100Q71558F
  • License MIT

Magnus — the orchestration layer above your IDE. Launches the full Magnus application (backend + UI) with one command.

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@magnus-ai/app) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    @magnus-ai/app

    The full Magnus runtime — backend + pre-built UI — packaged for one-command install.

    Magnus is the orchestration layer above your IDE: a multi-agent AI coding cockpit and central MCP hub. This package is the runtime. The IDE bridge is a separate package (@magnus-ai/mcp).

    Quick start

    # One terminal — start Magnus
npx -y @magnus-ai/app

# Another terminal — wire your IDE (Claude Code example)
claude mcp add magnus --scope user -- npx -y "@magnus-ai/mcp"
# On Windows, prefix the command with cmd /c.

    That's it. Magnus runs on http://localhost:3160 and the launcher auto-opens your default browser.

    What the launcher does

    1. Resolves a data directory — MAGNUS_DATA_DIR env if set, else ~/.magnus/data/. Created on first run.
    2. Spawns the Express backend (which serves both the API and the pre-built UI at the same port — no CORS, no two-port confusion).
    3. Polls /api/mc-health until the backend is alive.
    4. Opens http://localhost:3160/ in your default browser.
    5. Keeps the backend attached. Ctrl+C does a graceful shutdown.

    Environment overrides

    Variable Default Purpose
    MAGNUS_DATA_DIR ~/.magnus/data Where Magnus persists JSON state, the credentials vault, the embedding index, and the audit log.
    MAGNUS_PORT 3160 Backend / UI port.
    MAGNUS_NO_BROWSER unset Set to 1 to suppress the browser auto-open.
    MAGNUS_SMOKE unset Set to 1 (or pass --smoke) to boot, confirm health, and exit 0. For CI.

    API keys

    On first run, open the Settings modal (Ctrl+,) and paste your API keys for at least one of Anthropic, OpenAI, Google Gemini. Keys are encrypted at rest in the credentials vault. Alternatively, pre-populate a .env in the data dir:

    ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
GOOGLE_API_KEY=...

    Scope of v0.2.0

    This release embeds Magnus working-tree v5.99.38. Highlights since v0.1.8:

    • Receipts + inspector (v5.99.13–v5.99.19) — every run produces a structured consumption receipt; click-in-preview lands at the exact source line; inspector handles Next.js / Astro / Svelte.
    • Sandbox containment (v5.99.20–v5.99.23) — git-worktree mode with path-containment audit; Auto Mode opts in by default.
    • First-run wizard (v5.99.21) — API keys + workspace root + theme in three steps.
    • Telemetry + auto-debug (v5.99.24–v5.99.31) — opt-in (default OFF), Privacy panel, fix-notification piggyback, magnus_ask docs-grounded MCP assistant.
    • Preview launcher hardening (v5.99.32–v5.99.38) — operator-stop is no longer flagged as a crash, ETARGET vs ERESOLVE classifier with actionable error, dashboard cold-start pre-warm.

    Constraints (unchanged from v0.1):

    • JSON storage only. PostgreSQL via Drizzle is available in the full repo clone (set STORAGE_MODE=db); the npm app forces STORAGE_MODE=json for v1 simplicity.
    • Visual regression needs one extra step. Run npx playwright install chromium once if you want the screenshot diff feature.
    • Single operator. Team mode (auth, per-seat budget, shared playbook library) is parked roadmap material — build it when multi-user demand emerges.

    License

    MIT