# Official extension installer (`marqdo ext`) | | | |---|---| | Status | **Accepted (v0.1)** | | Date | 2026-08-07 | | Related | [ext-llm.md](ext-llm.md) · [ext-agent.md](ext-agent.md) · [ext-abi.md](ext-abi.md) | ## Commands ```text marqdo ext list marqdo ext add llm marqdo ext add agent marqdo ext remove llm marqdo ext remove agent ``` ## Install root 1. `MARQDO_EXT` if set 2. Else `~/.marqdo/ext` Imports use paths like `> ext/ai/llm.mq.md` (see [`load.rs`](../../src/load.rs)). ## Source for `add` 1. `MARQDO_EXT_SOURCE` — directory containing `ai/llm.mq.md` … 2. Else repo `./ext` near cwd / binary ## Layout (`ext/`) Official extensions live under **`ext/ai/`** (LLM + agent framework only). Do not add flat `.mq.md` files at `ext/` root — keeps the tree from accumulating unrelated modules. ```text ext/ ai/ llm.mq.md 大模型.mq.md agent.mq.md 智能体.mq.md ``` Future optional ext domains get their own subdirs (e.g. `ext/web/`, `ext/quantum/`), not mixed into `ai/`. ## Catalog | Id | Installs under `MARQDO_EXT` | |----|-----------------------------| | `llm` | `ai/llm.mq.md`, `ai/大模型.mq.md` | | `agent` | `ai/agent.mq.md`, `ai/智能体.mq.md`, **`native/libagent.so`** (or `.dylib`) | | `web` | `web/web.mq.md`, `web/网页.mq.md`, **`native/libweb.so`** — 见 [ext-web.md](ext-web.md) · [roadmap](../roadmap/ext-web.md) | | `quantum`(规划) | `quantum/quantum.mq.md`, `quantum/量子.mq.md`, **`native/libquantum.so`** — 见 [ext-quantum.md](../roadmap/ext-quantum.md) | `add agent` copies the built native plugin into `MARQDO_EXT/native/`. Build it first: ```bash cargo build -p marqdo_plugin_agent marqdo ext add agent ``` Without install, runtime resolves the plugin via `plugin.native_path name=agent` (see [ext-abi.md](ext-abi.md)): `MARQDO_AGENT_PLUGIN` → `CARGO_TARGET_DIR/{debug,release}/` → cwd `target/…` → beside `marqdo` binary → `MARQDO_EXT/native/`. ## Tests `tests/gold.rs`: `ext_cli_add_list_remove_llm`, `ext_cli_add_agent`, `ext_agent_framework_smoke`, `ext_agent_run_live` ([`tests/ext/agent-run-live.mq.md`](../../tests/ext/agent-run-live.mq.md); needs `tests/ext/.env` + built `libagent`). ## Non-goals - Third-party registry - Merging into `lib/` - Bundling domain/task helpers in official ext