Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Code Mavi IDE Documentation

Welcome to the Code Mavi IDE documentation! This comprehensive guide covers everything you need to know about Code Mavi IDE, the open-source, agent-first IDE.

Note: This documentation hub consolidates all project documentation including wiki content. For a quick overview, see Home.

📚 Documentation Categories

🚀 Getting Started

🏗️ Architecture

👥 For Users

💻 For Developers

🔧 For Contributors

🎯 Quick Links

Essential Reading

  1. Getting Started - First-time setup
  2. Architecture Overview - Understand the system
  3. Agent System - Learn about agents
  4. Contributing Guide - Start contributing

Key Concepts

  • Agent-First Architecture: Code Mavi IDE is built around intelligent agents
  • Triple Agent System: Orchestrator, Executor, and Verifier work together
  • Transparent Prompts: All system prompts are visible and editable
  • Self-Correction: Agents automatically fix errors (max 3 retries)
  • Checkpoint System: Safe rollback points before changes

📖 Documentation Philosophy

Transparency

All Code Mavi IDE documentation is:

  • Complete: Covers all features and APIs
  • Accurate: Regularly updated with the codebase
  • Practical: Includes real-world examples
  • Accessible: Written for different skill levels

Community-Driven

  • Documentation improvements welcome via PRs
  • Examples from real users encouraged
  • Translations for international community
  • Regular updates based on feedback

🔄 Keeping Updated

Version Compatibility

  • Documentation matches the latest release
  • Breaking changes are clearly marked
  • Migration guides for major updates
  • Deprecation notices with alternatives

Changelog

🤝 Getting Help

Support Channels

  • GitHub Issues: Bug reports and feature requests
  • GitHub Discussions: Questions and discussions
  • Discord Server: Real-time chat (link in main README)
  • Documentation Issues: Report documentation problems

Community Resources

  • Example Projects: Community-contributed examples
  • Rule Templates: Shared .mavi/rules.md templates
  • Prompt Library: Community-optimized agent prompts
  • Tool Extensions: User-created agent tools

📈 Learning Paths

For New Users

  1. Read Getting Started
  2. Try basic tasks with the User Guide
  3. Explore Custom Rules
  4. Experiment with Auto Dev Mode

For Developers

  1. Study Architecture Overview
  2. Review Contributing Guide
  3. Set up Development Environment
  4. Explore API Reference

For Contributors

  1. Understand Codebase Structure
  2. Review Roadmap
  3. Pick Good First Issues
  4. Join Community Channels

🎓 Tutorials and Examples

Beginner Tutorials

Advanced Tutorials

Real-World Examples

📋 Documentation Standards

Writing Guidelines

  • Use clear, concise language
  • Include code examples where helpful
  • Link to related documentation
  • Mark deprecated features clearly
  • Include troubleshooting sections

Style Guide

  • Headings: Use sentence case
  • Code: Use TypeScript/JavaScript examples
  • Images: Include alt text and captions
  • Links: Use descriptive link text
  • Notes: Use callouts for important information

🔍 Searching Documentation

Local Search

Use your browser's find function (Cmd+F / Ctrl+F) to search within pages.

Site Search

The documentation website includes full-text search across all pages.

GitHub Search

Search the documentation repository on GitHub for specific topics.

📝 Contributing to Documentation

How to Contribute

  1. Fork the repository
  2. Create a documentation branch
  3. Make your changes
  4. Submit a pull request

What to Contribute

  • Fix typos and grammatical errors
  • Add missing information
  • Improve examples
  • Translate to other languages
  • Add new tutorials

Documentation Review

All documentation changes are reviewed for:

  • Accuracy and completeness
  • Clarity and readability
  • Code example correctness
  • Link validity

📄 License

This documentation is licensed under CC BY-SA 4.0.

🙏 Acknowledgments

  • VS Code Team for the amazing foundation
  • Void Editor Contributors for the initial fork
  • Cursor Team for inspiration and innovation
  • All Contributors who help improve Code Mavi IDE

Last updated: $(date)
Documentation version: $(git describe --tags)

For the latest updates, check the GitHub repository.