Capture near-match, agent streaming, inheritance, table/map footnotes, plus planned web and quantum extensions with ABI and ext-cli install conventions. Co-authored-by: Cursor <cursoragent@cursor.com>
2.3 KiB
Official extension installer (marqdo ext)
| Status | Accepted (v0.1) |
| Date | 2026-08-07 |
| Related | ext-llm.md · ext-agent.md · ext-abi.md |
Commands
marqdo ext list
marqdo ext add llm
marqdo ext add agent
marqdo ext remove llm
marqdo ext remove agent
Install root
MARQDO_EXTif set- Else
~/.marqdo/ext
Imports use paths like > ext/ai/llm.mq.md (see load.rs).
Source for add
MARQDO_EXT_SOURCE— directory containingai/llm.mq.md…- Else repo
./extnear 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.
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 |
quantum(规划) |
quantum/quantum.mq.md, quantum/量子.mq.md, native/libquantum.so — 见 ext-quantum.md |
add agent copies the built native plugin into MARQDO_EXT/native/. Build it first:
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): 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; needs tests/ext/.env + built libagent).
Non-goals
- Third-party registry
- Merging into
lib/ - Bundling domain/task helpers in official ext