@magnitudedev/cli 0.0.1-alpha.2 → 0.0.1-alpha.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +97 -0
  2. package/package.json +29 -3
package/README.md ADDED
@@ -0,0 +1,97 @@
1
+ <p align="center">
2
+ <img src="wordmark.svg" alt="Magnitude" width="100%" />
3
+ </p>
4
+
5
+ <p align="center"><b>Open source AI coding agent</b></p>
6
+
7
+ <p align="center">
8
+ <a href="https://docs.magnitude.dev" target="_blank"><img src="https://img.shields.io/badge/📕-Docs-232f41?style=flat-square&labelColor=232f41&color=gray" alt="Documentation" /></a> <img src="https://img.shields.io/badge/License-Apache%202.0-232f41?style=flat-square&labelColor=232f41&color=gray" alt="License" /> <a href="https://discord.gg/VcdpMh9tTy" target="_blank"><img src="https://img.shields.io/discord/1305570963206836295?style=flat-square&logo=discord&logoColor=white&label=Discord&labelColor=5865F2&color=gray" alt="Discord" /></a> <a href="https://x.com/usemagnitude" target="_blank"><img src="https://img.shields.io/badge/-Follow%20Magnitude-000000?style=flat-square&labelColor=000000&color=gray&logo=x&logoColor=white" alt="Follow Magnitude" /></a>
9
+ </p>
10
+
11
+ Most coding agents are one long conversation that compacts and loses context. Magnitude is a multi-agent system that stays sharp over long horizon tasks.
12
+
13
+ - **Advanced orchestration** — Orchestrator delegates to subagents with two-way communication
14
+ - **Context stays clean** — Conversation stays focused on your intent. Less compaction, better UX
15
+ - **Parallel by default** — Spins up multiple subagents working concurrently, not one thing at a time
16
+ - **Native browser agent** — Vision-based browser agent verifies UI changes and behavior
17
+ - **Any model** — Frontier, open source, local, whatever you want
18
+
19
+ <p align="center">
20
+ <img src="interface.png" alt="Magnitude Interface" width="100%" />
21
+ </p>
22
+
23
+ ## Installation
24
+
25
+ ```bash
26
+ npm install -g @magnitudedev/cli
27
+ bun add -g @magnitudedev/cli
28
+ pnpm add -g @magnitudedev/cli
29
+ yarn global add @magnitudedev/cli
30
+ ```
31
+
32
+ After installation, just run `magnitude` in your terminal to launch the TUI:
33
+
34
+ ```bash
35
+ magnitude
36
+ ```
37
+
38
+ This will launch Magnitude with a setup wizard for configuring providers and models.
39
+
40
+ Optionally, run `/init` to automatically set up an [AGENTS.md](https://agents.md) for your project.
41
+
42
+ ### Skills
43
+
44
+ Magnitude supports the [Agent Skills](https://agentskills.io) standard. Skills are automatically discovered on launch from the following locations in order of priority:
45
+
46
+ 1. `<project>/.magnitude/skills/`
47
+ 2. `<project>/.agents/skills/`
48
+ 3. `~/.magnitude/skills/`
49
+ 4. `~/.agents/skills/`
50
+
51
+ ## Features
52
+
53
+ ### Orchestrator → subagent architecture
54
+
55
+ The orchestrator manages the conversation and delegates to specialized subagents (builder, debugger, explorer, planner, reviewer, browser), each with its own context window, toolset, and permissions. Subagents do focused work and report back, keeping the orchestrator's context clean.
56
+
57
+ ### Context sharing via artifacts
58
+
59
+ Named documents that carry context between agents with scoped visibility. An explorer writes findings, a planner reads them and writes a plan, a builder reads the plan and implements. Each agent sees exactly what it needs without inheriting everything.
60
+
61
+ ### Two-way agent communication
62
+
63
+ The orchestrator and subagents have full bidirectional messaging. The orchestrator can steer, redirect, or interrupt subagents mid-work. Not fire-and-forget delegation.
64
+
65
+ ### Event-sourced runtime
66
+
67
+ Every action is an immutable event. Sessions are fully replayable and resumable.
68
+
69
+ ### Built-in browser agent
70
+
71
+ A vision-based browser agent built on [browser-agent](https://github.com/magnitudedev/browser-agent) runs natively in the same runtime. Used to verify UI changes and behavior.
72
+
73
+ ### Steerable and hackable
74
+
75
+ Skills, AGENTS.md, persistent memory, agent policies. The system adapts to how you work, not the other way around. Magnitude learns your preferences and codebase conventions over time, storing them in `.magnitude/memory.md` and applying them automatically to future sessions.
76
+
77
+ ## Additional Info
78
+
79
+ ### Provider and model support
80
+
81
+ See the [providers](https://docs.magnitude.dev/configuration/providers) and [models](https://docs.magnitude.dev/configuration/models) pages in the docs. If you would like another provider to be supported, please feel free to create an issue or raise a PR yourself.
82
+
83
+ ### Contributing
84
+
85
+ See the [contributing guide](https://docs.magnitude.dev/contributing) to get started.
86
+
87
+ ### Documentation
88
+
89
+ Full documentation is available at [docs.magnitude.dev](https://docs.magnitude.dev).
90
+
91
+ ### Acknowledgements
92
+
93
+ Built on top of [BAML](https://boundaryml.com), [Effect](https://effect.website), and [OpenTUI](https://github.com/anomalyco/opentui).
94
+
95
+ Inspired by other open-source coding agents, including [OpenCode](https://github.com/anomalyco/opencode) and [Codex](https://github.com/openai/codex).
96
+
97
+ The future is open!
package/package.json CHANGED
@@ -1,8 +1,33 @@
1
1
  {
2
2
  "name": "@magnitudedev/cli",
3
- "version": "0.0.1-alpha.2",
3
+ "version": "0.0.1-alpha.3",
4
4
  "description": "Magnitude AI coding agent",
5
- "license": "MIT",
5
+ "license": "Apache-2.0",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "https://github.com/magnitudedev/magnitude.git",
9
+ "directory": "packages/cli"
10
+ },
11
+ "homepage": "https://github.com/magnitudedev/magnitude",
12
+ "bugs": {
13
+ "url": "https://github.com/magnitudedev/magnitude/issues"
14
+ },
15
+ "keywords": [
16
+ "ai",
17
+ "coding",
18
+ "agent",
19
+ "cli",
20
+ "magnitude"
21
+ ],
22
+ "author": {
23
+ "name": "Magnitude",
24
+ "email": "founders@magnitude.dev",
25
+ "url": "https://magnitude.dev"
26
+ },
27
+ "contributors": [
28
+ "Anders Lie <anders@magnitude.dev>",
29
+ "Tom Greenwald <tom@magnitude.dev>"
30
+ ],
6
31
  "bin": {
7
32
  "magnitude": "bin/magnitude.js"
8
33
  },
@@ -11,7 +36,8 @@
11
36
  "lib"
12
37
  ],
13
38
  "scripts": {
14
- "postinstall": "node lib/postinstall.js"
39
+ "postinstall": "node lib/postinstall.js",
40
+ "prepack": "cp ../../README.md ./README.md"
15
41
  },
16
42
  "publishConfig": {
17
43
  "access": "public"