How to use Minke
Adds LM Studio/Ollama local models, Codex sub-agents, file/terminal/web workspace, and keyboard shortcuts with desktop theme synchronization to DeepSeek Harness.
This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.
This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.
Quick start
Minke
— source: plugin_wiki.wiki_content
Install & verify
dsh plugin --profile web add github:lencx/Minke#path:packages/harness-overlay
Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.
— source: plugins.install
Key points
- Git with submodule support. The
vendor/deepseek-harnesssubmodule must be checked out. - Node.js 24 or newer.
- pnpm 11.7.0, with the repository dependencies installed before running the scripts.
- macOS: an Apple Silicon or Intel Mac with Xcode Command Line Tools. The
.dmgtarget can only be built on macOS. - Windows: a Windows x64 host. Visual Studio 2022 Build Tools with the Desktop development with C++ workload may be needed if a native dependency must be compiled locally.
— source: plugin_wiki.readme_en (fallback readme_raw)
FAQ
What is this plugin? Which Minke package should I install?
Minke Desktop consists of multiple packages. The harness-overlay is the product customization layer injected into the host DSH runtime. It is installed separately into an existing Harness runtime via the DSH plugin command. If you download the Minke Desktop installer from GitHub Releases, the desktop application already includes this layer and does not require a separate add.
Can I use LM Studio and Ollama directly after installing?
By default, only locally running LM Studio/Ollama instances are discovered (lifecycle=external). To enable auto-start, set modelRuntime.{lmStudio,ollama}.enabled to true in ~/.minke/desktop/minke.config.json and provide the CLI path environment variable when starting Minke. For manually connecting any OpenAI-compatible loopback service, use the openAICompatible list.
How does the provided Codex sub-agent work?
This layer injects dsh-subagent-codex and tool-subagent (provider=codex) into Harness, delegating tasks to the local codex app-server --stdio. Codex's own login, models, sandbox, and workspace behaviors are entirely managed by the Codex CLI itself and are not within the plugin's permissions.
Can I change the shortcut keys?
Yes. There are 8 default actions (palette.open / settings.open / session.new, etc.). After modification through the product settings page, they are persisted via IPC through the minke:shortcut-settings:read|write channel. The schema is validated in shortcut-contract.ts, with a maximum of 128 entries, expressed using the Mod+Shift+...+Key format.
What's different when installed on Windows or Linux vs macOS?
It works across all platforms. macOS additionally enables desktop Surface adaptations like translucency, sidebar, and titlebar. Windows and Linux retain the platform's default styling, and are gated by the isolated preload capability. On dispose, listeners and stylesheets are removed.
What happens when I uninstall?
On uninstall, the plugin effect calls prepared.dispose(): it only stops services started by this plugin (LM Studio cleanup only occurs on instances explicitly started by this plugin; if Ollama's ollama serve was spawned by this process, it will also be closed). The managed strategy recycles external services based on the "started by this plugin" condition during plugin disposal.
— source: plugin_wiki.faq_json
Compatibility
- DSH: 未声明
- Node: >=24
— source: plugin_wiki.compatibility_json
Pitfalls
Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.
— source: general rule