Files
marqdo/doc/design/ext-cli.md
T
cflmyandCursor 1f23e2ed93 Add module namespaces and harden L1/agent after the import redesign.
Bind imports to library names with bare path calls (and use), forward optional host args through mq wrappers, stabilize writeback replacement newlines, and document the M1/M2 decisions.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-07 13:28:32 +08:00

2.0 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

  1. MARQDO_EXT if set
  2. Else ~/.marqdo/ext

Imports use paths like > ext/ai/llm.mq.md (see 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.

ext/
  ai/
    llm.mq.md
    大模型.mq.md
    agent.mq.md
    智能体.mq.md

Future optional ext domains get their own subdirs (e.g. ext/foo/), 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)

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