# Esedre: Open Developer Planning Engine & MCP Server

> Esedre is a standalone open developer roadmap, ticketing engine, CLI utility (`ese`), local Web UI, and Model Context Protocol (MCP) server for developers and autonomous LLM coding agents. Its primary mission is providing long-term grounding to LLM agent context by maintaining structured, git-backed roadmaps, architectural plans, and verification records across multi-turn sessions, context compactions, and developer handoffs.

## Core Capabilities & Architecture

- [Interactive Developer Overview](https://esedre.com/): Product overview covering the local Web UI, gateway cluster, interactive sandbox demo, and token-based theming.
- [Long-Term Agent Grounding](https://esedre.com/#features): Plain-text git-backed roadmaps (`meta.json`, `detail.md`, `comments.json`) that preserve high-fidelity context across LLM context window compactions and agent turns.
- [Sequential Per-Project Numbering](https://esedre.com/#/docs/cli): Clean per-project sequential ticketing (#1..N) with case-remembering project codes (e.g. `Esedre-1`, `Prof-35`, `Alce-1`).
- [Multi-Topology Storage Engine](https://esedre.com/#topologies): Dynamically resolves planning data across 6 topology patterns: Single Hub (`dataDir`), In-Repo Standalone (`.esedre/`), Multi-Hub (`dataDir: [...]`), Federated Multi-Repo (`projects: {...}`), Hybrid, and Monorepo auto-discovery.
- [Multi-Project Agent Isolation](https://esedre.com/#/docs/isolation): Agent Project Allow-List (`allowedProjects`) guaranteeing zero cross-project planning leakage during autonomous coding sessions.
- [Universal MCP Server](https://esedre.com/#mcp): Standard Model Context Protocol integration providing first-class planning tools (`list_tickets`, `get_ticket`, `create_ticket`, `update_ticket`, `get_plan`, `save_plan`, `add_comment`) to Cursor, Claude Desktop, Antigravity, and custom agent runners.
- [Unified Daemon & Gateway](https://esedre.com/#/docs/daemon): Background process detachment (`ese start`, `ese stop`, `ese status`) routing Web UI (port 5675) and REST API (port 5676) through a unified gateway (default port 5674).
- [Drop-in Embeddable View](https://esedre.com/#embed): Reusable `<PlannedWorkView />` component for host applications with zero-effort CSS variable theme inheritance.

## Documentation Hub Endpoints

- [Documentation Hub](https://esedre.com/#/docs): Central technical documentation and architecture reference.
- [CLI Reference](https://esedre.com/#/docs/cli): Complete command catalog (`ese init`, `ese start`, `ese list`, `ese get`, `ese plan`, `ese update`, `ese comment`, `ese snapshot`).
- [Daemon Lifecycle](https://esedre.com/#/docs/daemon): Server cluster management, detached process patterns, and HTTP diagnostics.
- [Topologies Guide](https://esedre.com/#/docs/topologies): Storage configuration for central hubs, standalone repositories, and hybrid setups.
- [Agent MCP Protocol](https://esedre.com/#/docs/mcp): Tool schemas, parameters, and agent system prompt instructions.
- [Embed & Theming](https://esedre.com/#/docs/embed): Drop-in integration guide with CSS design token contracts.
- [Contact & Inquiries](https://esedre.com/#/contact): Inbound channels for general inquiries (`contact@esedre.com`) and RFC 9116 security disclosures (`security@esedre.com`).

## Privacy & Local-First Principles

- **100% Local & Git-Backed**: Planning data resides entirely on your local filesystem in standard JSON and Markdown. No remote servers, cloud databases, or mandatory accounts.
- **Zero Third-Party Telemetry**: Zero tracking pixels, analytics beacons, or remote logging.
- **Open-Source Freedom**: Licensed under Mozilla Public License 2.0 (MPL-2.0).

## Deep Technical Reference

- [Extended Technical Platform Reference](https://esedre.com/llms-full.txt): In-depth reference for CLI commands, JSON-RPC schemas, topology configuration files, and Agent Project Allow-List security invariants.