# MeshCtx — llms.txt
# AI Agent accessibility for MeshCtx v3.136.22 documentation
# Last updated: 2026-09-02

## MeshCtx
MeshCtx is an open-core, self-adaptive AI agent platform with full-brain emulation (17 brain regions), code sandbox, project indexing, Agent Hub task delegation and Feishu notifications. Open-core: AGPLv3 framework + source-available brain algorithms. Three editions: Personal (free, open-source AGPLv3), Team ($9/user/month) and Enterprise ($29/user/month).

## Core Features
- 🧠 Super Brain: 17 brain regions (Hippocampal Replay, Amygdala Salience, Default Mode Network, Thalamic Gate, Cerebellar Forward Model, Basal Ganglia, ACC, Mirror Neurons, Insula, PFC Working Memory, Visual Cortex, NAcc Reward Prediction, Brainstem Autonomic, STDP Plasticity, IIT Integration, LTP Enhancement, Gnostic Field)
- 🖥️ Code Sandbox: Safe Python/Bash/JS execution with Docker isolation + subprocess fallback + SSE streaming
- 📂 Project Indexer: 15+ language symbol extraction, file change monitoring, /context command
- 📨 Feishu Notifier: Card/text/deploy notifications with HMAC signature
- 🔍 Web Search: /search command via DuckDuckGo API
- 📄 Local File Access: /read /ls commands with WSL path translation
- 🧠 Hierarchical Memory (L0-L4) with Ebbinghaus Forgetting Curve
- 🔄 Meta-Cognition: evaluate → extract → update → adjust
- 🎭 Multi-Agent Orchestra with DAG decomposition
- 🗂️ Agent Hub / Task Cards: one-line task delegation → background task cards with visible progress; cancel, retry and approve dangerous operations right from the UI or your phone
- 💳 3 Editions: Personal (free forever, open-core AGPLv3) · Team ($9/user/month) · Enterprise ($29/user/month, SSO + admin controls)
- 🔌 Plugin Marketplace: 9 built-in capability plugins (messaging / memory / security / monitoring)
- 🌐 11-language i18n (EN/ZH/JA/KO/FR/DE/ES/IT/AR/RU/HE)
- 💻 Windows/Linux cross-platform (macOS pending)

## Quick Links
- Homepage: https://meshctx.com
- GitHub: https://github.com/LucyAndLuna2023/meshctx
- API Docs: https://meshctx.com/docs (Swagger at /docs when running)
- Download: https://meshctx.com/#download
- Setup: /ui/setup | Chat: /ui/chat | Desktop: /ui/desktop

## Installation
- Windows: meshctx-setup.exe from GitHub Releases (latest)
- Linux: git clone + python3 -m venv .venv + pip install -e .
- Start: mesctx start (Web) | mesctx desktop (Native window)

## API Endpoints (v3.121)
### System
- GET /api/system/summary — System overview
- GET /health — Health check

### Chat & Agent
- POST /api/chat — Chat completion
- POST /api/chat/stream — Streaming chat (SSE)
- POST /api/chat/upload — Upload file context
- POST /agent/start | /agent/stop — Agent loop control

### Sandbox (v2.7+)
- POST /api/sandbox/execute — Execute code (Python/Bash/JS)
- POST /api/sandbox/execute/stream — Streaming SSE execution

### Project Indexer (v2.7+)
- GET /api/project/index — Index status & stats
- GET /api/project/search?q= — Search project files
- GET /api/project/context?q= — Get code context for LLM

### Feishu (v2.8+)
- POST /api/feishu/test — Test webhook connection
- POST /api/feishu/notify — Send notification (text/card/deploy)

### Web Search (v2.7+)
- GET /api/search?q= — DuckDuckGo web search

### File Access (v2.2+)
- GET /api/file/read?path= — Read local file
- GET /api/file/list?path= — List directory

### Models
- GET /api/models — List all
- POST /api/models — Add | PUT /api/models/{id} — Update
- DELETE /api/models/{id} — Delete
- POST /api/models/{id}/test — Test connection

### Plugins (v2.1+)
- GET /api/plugins — List all (9 plugins)
- GET /api/plugins/{name} — Plugin detail
- POST /api/plugins/install/{name} — Install/activate
- POST /api/plugins/uninstall/{name} — Uninstall

### Brain Monitor
- GET /api/brain/status — 17-region brain status

## Project Structure
- src/core/ — Core engine (sandbox, project_indexer, feishu_notify, super_brain, brain_router, free_energy, active_inference, global_workspace, homeostasis, metacognition, hybrid_reasoning)
- src/web_ui.py — Web UI + Desktop Dashboard (Jinja2 templates)
- src/main.py — FastAPI app (15+ endpoint groups)
- plugins/ — Plugin registry + manifests (9 built-in plugins)
- tests/ — 673 tests, all passing
- docs/ — GitHub Pages deployment (meshctx.com)

## Chat Commands
- /read <path> — Read local file
- /ls <path> — List directory
- /search <query> — Web search
- /run [python|bash|js] <code> — Execute in sandbox
- /context <query> — Search project codebase

## Optional
- License: AGPLv3 (framework) + Commercial (brain algorithms) — license@meshctx.com
- Benchmark: tests/benchmark_v19.py (76/100 Super Brain score)