Adapt User Manual

Welcome to the comprehensive manual for Adapt, the adaptive file-backed web server. This manual provides detailed documentation for users, administrators, and developers working with Adapt.

Table of Contents

  1. Overview - Introduction to Adapt and its capabilities
  2. Installation - How to install and set up Adapt
  3. Quick Start - Getting started with your first Adapt server
  4. User Guide - Using Adapt as an end user
  5. API Reference - Complete API documentation
  6. Admin Guide - Managing users, permissions, and system administration
  7. Security - Authentication, authorization, and security features
  8. MCP Guide - Connecting agentic tools via the Model Context Protocol
  9. Configuration - Configuration options and CLI commands
  10. Plugin Development - Creating custom plugins
  11. Architecture - Internal architecture and design
  12. Troubleshooting - Common issues and solutions
  13. Known Limitations - Current implementation limits and workarounds

About This Manual

This manual is Adapt's authoritative user documentation. It describes the behavior of the running implementation on main, which is the source of truth. The documents in ../spec/ are implementation specifications, not a roadmap or a promise of future behavior.

Unimplemented ideas are labeled Future work. Known implementation defects are documented as limitations instead of being described as working behavior. See the documentation contract for the maintenance rules and scope.