README
T
Agent
T
TranslateOptions

mdt

Native MoonBit CLI for translating Markdown with OpenCode or Codex

markdown

translation

opencode

cli

Download zip

Author

totto2727

Version

0.1.9

License

MIT

Repository

github.com/totto2727-org/mdt

Last updated

2 months ago

Downloads

#mdt

A native MoonBit CLI that translates one Markdown file through the installed OpenCode or Codex CLI. It uses the provider-neutral totto2727/agent-sdk/cli contract with provider adapters, retains provider-native options only at the composition root, reuses existing authentication, and denies every OpenCode tool through OPENCODE_CONFIG_CONTENT.

#Usage

mdt <file> --lang <code> [--agent <opencode|codex>] [--model <model>] [--force]

Flag	Environment	Description	Default
--lang, -l		Target language code, such as ja or ja-JP	required
--agent	MDT_AGENT	Agent CLI: opencode or codex	opencode
--model, -m	MDT_MODEL	OpenCode provider/model or Codex model ID	OpenCode: opencode-go/deepseek-v4-flash; Codex: gpt-5.6-luna
--force, -f		Overwrite an existing output file	off

Command-line options override environment variables, which override the defaults.

The output is written beside the input with the normalized language tag before its extension. Existing language tags are replaced, and compound .mbt.md extensions are preserved.

README.md         -> README.ja.md
guide.en.md       -> guide.ja.md
module.mbt.md     -> module.ja.mbt.md
module.en.mbt.md  -> module.ja.mbt.md

#Development

Enter the Nix development shell, then validate the package:

nix develop
moon check
moon test
moon package --list

Build the installable package with nix build .#mdt.

#How it works

Admiral parses the input path and options into typed command data.
The CLI refuses to overwrite an existing output before starting the selected provider unless --force is present.
totto2727/agent-sdk/cli sends the common translation prompt to the selected provider adapter.
The OpenCode adapter starts opencode run --format json with the selected provider/model and sends a deny-all permission configuration through OPENCODE_CONFIG_CONTENT.
The Codex adapter passes the selected model ID, defaults to gpt-5.6-luna, and applies approval_policy=never, --sandbox read-only, and --skip-git-repo-check.
Provider JSONL text events are joined by the adapter and written to the resolved output path.