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
brew tap marcelotto/tap
brew install magmaDownload 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/magmamagma versionInitialize a new vault:
magma initThen open the vault folder in Obsidian. See the User Guide for detailed usage instructions.
- 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
See the open issues or the Limitations section in the User Guide.
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!
 |
 |
This project was funded through NGI Assure, a fund established by NLnet with financial support from the European Commission's Next Generation Internet program.
Distributed under the MIT License. See LICENSE.md for more information.