Skip to main content

​
Prerequisites

Magnitude is built with Bun. Install it first: 
curl -fsSL https://bun.sh/install | bash

​
Clone and install

git clone https://github.com/magnitudedev/magnitude.git
cd magnitude
bun install

​
Running in development

bun run dev
This starts Magnitude in development mode with the debug panel available (toggle with Ctrl+D). You can also pass --debug when running the installed CLI (magnitude --debug) for the same debug panel.

​
Running tests

bun test

​
Monorepo structure

PackageDescription
cli/Terminal UI (React + OpenTUI)
packages/agent/Agent core (team lead, subagents, execution, tools)
packages/agent-definition/Agent type definitions and prompts
packages/xml-act/XML-ACT protocol runtime (parser, execution, composition)
packages/llm-core/LLM abstraction layer (BAML)
packages/ripgrep/Bundled ripgrep binary for file search
packages/logger/Structured logging
packages/providers/Provider registry, auth, model management
packages/event-core/Event-driven framework (projections, workers, signals)
packages/tools/Tool definition framework
packages/browser-harness/Playwright browser automation
packages/telemetry/Anonymous usage telemetry
packages/tracing/Tracing and debugging
packages/roles/Agent role definitions and helpers
packages/shell-classifier/Shell command safety classification
packages/skills/Reusable agent skill definitions
packages/storage/Session and config storage layer
packages/markdown-cst/Markdown concrete syntax tree parser
packages/generate-id/ID generation utilities
packages/image/Image processing utilities
packages/dom-extract/DOM content extraction for browser agent

​
Session and debug tools

Inspect past sessions with bun session: 
bun session list
bun session events <id>
bun session events <id> --type turn_started,user_message
bun session search <keyword> <id>
bun session projection <id> Memory
View logger output for the current session: 
bun logs
Session files are stored under ~/.magnitude/sessions/.