M Magent eMacs-native LLM AGENT

Documentation Overview

Welcome to the Magent documentation. Magent is an Emacs Lisp AI coding agent with multi-agent architecture, permission-based tool access, and LLM integration via gptel.

Documentation Index

Getting Started

  • COMMANDS.org — Slash commands, internal LLM workflows, and their management commands
  • ONBOARDING.org — New developer onboarding guide with architecture overview, guided tour, and complexity hotspots
  • TROUBLESHOOTING.org — Common issues and solutions

Architecture

  • ARCHITECTURE.org — Product positioning, system boundaries, module layers, request flow, and capability model
  • AGENT_WORKFLOW.org — Thread/turn/item state machine, loop flow, persistence (snapshot + journal), UI projection, and Codex alignment
  • AGENT_JOBS.org — Durable child-agent job lifecycle, tool surface, persistence, UI, and boundaries
  • UI_BACKENDS.org — Supported agent-shell + ACP flow and the unsupported legacy UI boundary
  • DOCTOR.org — Safe Doctor probe API, trust boundary, redaction, sessions, and cancellation

Contribution

Project Root Documentation

  • ../README.org — Main project README with features, installation, and usage
  • ../AGENTS.md — Development guide for agentic coding tools with build commands, architecture notes, and repository conventions

Quick Links

For New Contributors

  1. Start with ONBOARDING.org
  2. Read CONTRIBUTING.org for development workflow
  3. Read ../AGENTS.md for current architecture notes and development guidance
  4. Read AGENT_JOBS.org before changing child-agent lifecycle behavior

For Users

  1. ../README.org — Installation and configuration
  2. COMMANDS.org — Built-in slash commands and Magent-owned LLM workflows
  3. TROUBLESHOOTING.org — Common issues and solutions
  4. Run M-x magent-run-doctor for self-diagnostics
  5. Use M-x magent-agent-shell-dwim to open the supported agent-shell UI

For Developers

  1. CONTRIBUTING.org — Code style and PR process
  2. ../AGENTS.md — Build commands, testing, architecture notes, and development guidance
  3. ARCHITECTURE.org — Current architecture and system boundaries
  4. ONBOARDING.org — Guided code tour and complexity hotspots
  5. AGENT_JOBS.org — Current child-agent job architecture
  6. UI_BACKENDS.org — Current frontend support boundary
  7. DOCTOR.org — Doctor data boundary and extension contract

CI And Packaging

  1. ../README.org — Public workflow badges and development commands
  2. CONTRIBUTING.org — Local and CI verification sequence
  3. TROUBLESHOOTING.org — Known GitHub Actions failure signatures
  4. ../AGENTS.md — Agent-facing test, coverage, live smoke, and melpazoid notes

Documentation Standards

When adding new documentation:

  • Place user-facing docs in project root (README.org)
  • Place developer docs in docs/
  • Use Org for docs under docs/; generated HTML is build output under _site/.
  • Update this index when adding new files
  • Keep stable docs or active task notes updated before stopping work so another machine can resume from git