Markdown Workspace

A built-in Level 0 HaloForge plugin that adds an AI-native Markdown workspace to the left sidebar.

Current MVP scaffold

• Sidebar-level Markdown module
• Open Markdown files from a native file picker
• Save Markdown files back to disk with existing line-ending preservation
• Persist recently opened files in the plugin database
• High-quality Markdown rendering using the shared renderer
• Read / split / write workspace modes
• Vditor IR realtime-render editing in write mode, plus source editing with shared preview in split mode
• Selection-aware AI reading panel scaffold backed by the existing AI Chat transport
• Startup file-open bridge, macOS Opened event handling, and window drag-and-drop bridge
• Manifest window.document_handlers registration for .md, .markdown, .mdown, and .mkd

Plugin boundaries

• Frontend UI lives under app/
• Native commands live under backend/
• The plugin is packaged independently from the main HaloForge app

Packaging

This repository builds independently from the main HaloForge app. The backend uses the published haloforge-plugin-api crate, and the frontend uses @haloforge/plugin-sdk.

Local package check:

npx @haloforge/plugin-pack@0.2.13 check .
npx @haloforge/plugin-pack@0.2.13 pack . --release --out dist/plugin-release

Install the packaged plugin into a local HaloForge workspace with the hf CLI:

cd /path/to/HaloForge
npm run hf -- plugin install local /path/to/hf-plugin-markdown/dist/plugin-release/dev.haloforge.markdown-0.2.7.hfpkg --json
npm run hf -- plugin list --json

npm run hf -- ... is the source-checkout form. Windows installed builds add hf to PATH, so a new terminal can use hf plugin ... directly. macOS automatic PATH linking is not implemented yet; run command -v hf before assuming the global command exists.

GitHub release packaging uses .github/workflows/plugin-release.yml and the public /plugin-pack npm package. Set HF_ADMIN_TOKEN to submit generated catalog metadata to the production plugin catalog.

This plugin now uses only the documented @haloforge/plugin-sdk surface for host navigation, file intents, file dialogs, theme access, host AI transport, and host event subscriptions. It no longer depends on window.__HF_HOST or hard-coded HaloForge host commands in plugin source.

Vditor is maintained as a git subtree from the HaloForgeAI/vditor fork on the haloforge/markdown branch. See VENDORING.md for the update workflow and THIRD_PARTY_NOTICES.md for bundled editor/runtime notices.

Next evolution

• AST-backed document model
• Inline AI patch accept / reject flow
• Windows/macOS single-instance file-open forwarding
• Chunk-aware retrieval and semantic search across Markdown workspaces