Magma

An IDE for prompts.

Explore the docs »

Changelog · Forum · Report Bug · Request Feature

About the Project

Magma is a prompt development environment designed for working with coding agents like Claude Code, Codex, Gemini CLI, OpenCode and similar AI-powered development tools. While these tools are primarily designed for software development, they are increasingly used for a broader range of knowledge work tasks, making Magma useful beyond just coding.

At its core, Magma provides a knowledge base system built on Obsidian-compatible markdown documents that enables rapid composition of prompts through transclusions. This allows you to build reusable prompt libraries where complex prompts are assembled from smaller, well-defined pieces of knowledge.

Read on in the User Guide

Installation

Homebrew (macOS & Linux)

brew tap marcelotto/tap
brew install magma

Manual Installation

Download the latest release for your platform from the Releases page.

Place the binary in your PATH (e.g., /usr/local/bin/):

chmod +x magma_macos_arm
mv magma_macos_arm /usr/local/bin/magma

Verify Installation

magma version

Quick Start

Initialize a new vault:

magma init

Then open the vault folder in Obsidian. See the User Guide for detailed usage instructions.

Features

• Transclusion resolution system for rapid prompt composition from existing knowledge fragments
• Session-based workflow for iterative conversations with coding agents that maintain conversation history
• Coding agent integration with support for file reference syntax (@"path/to/file.md")
• Organized vault structure with templates for different document types (Prompts and Sessions)
• Clean separation of prompts, responses, and notes within Session documents
• Obsidian integration with adaptability to many use cases through Obsidian's vast plugin ecosystem

Known Limitations

See the open issues or the Limitations section in the User Guide.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. See CONTRIBUTING for details. You can also simply start a new discussion here

Don't forget to give the project a star! Thanks!

Funding

This project was funded through NGI Assure, a fund established by NLnet with financial support from the European Commission's Next Generation Internet program.

License

Distributed under the MIT License. See LICENSE.md for more information.