DSH Marketplace

mirage

strukto-ai/mirage#dsh

Swaps the filesystem and bash providers for a mirage virtual workspace: file tools and shell commands run over mounted resources (RAM, S3, Redis, Slack, Gmail, Notion, Postgres) instead of the host disk, with per-mount read/write/exec modes, per-command sandbox routing (monty, pyodide, quickjs in process; docker, e2b, daytona remote), and installed CLIs (git, gh, slack, linear, ntn, gws, or one you register) as head words in the virtual terminal.

3,717274TypeScriptApache-2.0Source

Install

Add mirage to DeepSeek Harness

This plugin lives in a subdirectory of a larger repository, and `dsh plugin add` cannot reach it — it forwards to pnpm, which reads everything after `#` as a git branch or commit. Clone the repository and add the plugin through DSH's plugin panel using a repository source, or ask the author to publish it to npm.

Due diligence

Before you install mirage

  • Source of record: strukto-ai/mirage — present in the community registry that DSH's own plugin market installs from.
  • Licensed under Apache-2.0.

Security

What installing mirage runs

Build scripts

Not measured — we have not installed it yet.

Install hooks

package.json declares no preinstall, install or postinstall script.

Source: package.json on GitHub, read at our last sync. prepare is not recorded; it runs only on a GitHub install, and shows up under build scripts when pnpm blocks it.

README mentions

shell commands (bash, exec, spawn …)

Source: a keyword match on the README — a hint about what the plugin touches, not an analysis of its code.

Not an audit. These are the record of one install and two text scans; nobody has read this plugin's code on your behalf. Plugins run with your agent's permissions.

The AI take

What it is — mirage provides a unified virtual filesystem for AI agents, allowing bash tools to operate across mounted resources.

Who it is for — It is suitable for AI agents that use bash tools and need to access multiple backends such as S3 and Slack at the same time. It is not suitable for agents that only run on local filesystems without remote mounted services.

Watch out — No obvious issues found. There is a static check prompt indicating it will execute shell commands. Sandbox testing was not performed.

The verdict — I would not install it because sandbox testing was not performed.

Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.

What mirage does

Mounted resource blocks flow through permission gates into terminal pipelines and local or remote sandboxes.

mirage is a DeepSeek Harness plugin that replaces the filesystem and bash providers with a virtual workspace spanning mounted services and data sources. It presents resources such as RAM, S3, Redis, Slack, Gmail, Notion and Postgres as paths, so file tools and shell commands operate on those mounts rather than the host disk. Mounts can be assigned read, write or execute modes, and commands can be routed to runtimes such as in-process monty, pyodide and quickjs, or remote docker, e2b and daytona sandboxes.

The plugin exposes a virtual terminal with standard commands such as grep, cp, cat and pipelines, and can register typed CLIs as head words. The README names git, gh, slack, linear, ntn and gws, while custom programs can also be registered. A workspace can be created from a mapping such as "/s3": S3Resource(...), executed with ws.execute(...), and saved with ws.snapshot(...).

mirage is intended for agents that need one shell-like interface across cloud services, messaging systems, databases and files. It reaches every resource mounted into the workspace and may execute commands or scripts through the selected runtime, so its terminal surface should be treated as an access path to those resources. It is a poor fit when ordinary host filesystem and bash providers are sufficient, or where the required platform support is unavailable: the documented environment is macOS or Linux, and FUSE-based mounts require platform support.

mirage documentation

Workspace configuration

A workspace is constructed with mount paths mapped to resources. The README shows RAMResource() and S3Resource(S3Config(bucket="my-bucket")); a mount can also include a mode such as MountMode.EXEC or MountMode.WRITE.

Configuration Purpose
Workspace({...}) Creates the virtual workspace from mount paths and resources
S3Config(bucket=...) Selects the S3 bucket for S3Resource
MountMode.EXEC Mount mode used in the examples for executable access
MountMode.WRITE Mount mode used in the examples for writable access
runtimes=[...] Selects command runtimes; MontyRuntime(captures=["python", "python3"]) captures those command names
ws.register_cli(name, implementation, config) Registers a CLI under a virtual-terminal head word

The README also shows credentials supplied through resource or CLI configuration, including S3Config(...) and a Slack configuration containing token.

Commands and workspace operations

ws.execute("...") runs a shell command in the workspace. Documented examples use cp, grep, wc, pipes and redirected output. A script stored in a mounted resource can be invoked with python3, for example python3 /slack/...py > /redis/report.txt.

The command-line interface provides mirage workspace create, mirage execute, mirage provision, mirage workspace snapshot and mirage workspace load. The examples use --workspace_id, --command and --id, and save snapshots as .tar files. ws.snapshot("demo.tar") provides the SDK equivalent.

Resources and runtimes

The README lists mounts for RAM, disk, Redis, S3-compatible services, Gmail and Google Drive services, GitHub, Linear, Notion, Trello, Slack, Discord, email, MongoDB, Postgres, LanceDB, Qdrant and SSH. The upstream summary additionally identifies S3, Redis, Slack, Gmail, Notion and Postgres as DSH-mounted resources. Runtime choices include in-process monty, pyodide and quickjs, plus remote docker, e2b and daytona.

Requirements and platform

The documented SDK requirements are Python >=3.11 for mirage-ai, Node.js >=20 for the TypeScript SDK, and macOS or Linux. FUSE-based mounts require platform support. The TypeScript packages include @struktoai/mirage-node, @struktoai/mirage-browser and @struktoai/mirage-agents.

Written from the project's own documentation and kept in sync with it. Where the two disagree, the source is authoritative — read the README on GitHub

Same category

Alternatives to mirage

7.0k

One repository, three parts: a runtime injector for DSH plugin packages (inject, hot-reload, unload, promote a dev staging tool to the front, route self-heal, plus a settings-page plugin manager that lists, unloads and drags folders in to internalize), a task-aware reasoning-mode router agent preset (router-standard / router-spec / router-react), and a graded two-level task protocol whose six tools (commit_star, lock_stage, revise_do, edit_plan, mark_task, redteam_verdict) pin task state to disk. The injector implementation ships in-tree, so the install carries its own behaviour rather than a dependency list.

Installs, but needs a build approved first

GitHub sourceJavaScript1mo ago

AI review

dsh-routing-suite

What it is — A DSH suite that ships a runtime injector, task-aware reasoning-mode presets, and a graded two-level protocol whose six tools pin task state to disk.

Who it is for — You are on DSH 0.1 preview with DeepSeek Pro or Flash, running spec-then-execute work that needs the agent to switch reasoning modes by task and to write stage state to disk. Skip it when your DSH is already outside >=0.1.0-rc.6 <0.2.0; the preview still breaks APIs, so the version window is the constraint, not the job type.

Watch out — In our run the install started, then pnpm blocked the build script and DSH never finished registration. Until that build is allowed by hand, the plugin does not actually land.

The verdict — I'll take it only after unlocking the blocked build: the injector ships in-tree, so that allow step is how you accept this runtime's behaviour rather than a dependency list.

Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.Read the source
Source

oh-my-agent

first-fluke

1.4k

Runs project OMA checks before and after tool execution and when a turn tries to finish. Installs its OMA CLI dependency and initializes unconfigured projects on first use. Requires Node.js 22+; initial setup needs network access and project write access.

No one-line install — this plugin lives inside a larger repository and publishes no npm package.

GitHub sourceTypeScript24d ago

AI review

oh-my-agent

What it is — oh-my-agent runs project OMA checks before and after tool execution and when a turn tries to finish, installing its OMA CLI dependency and initializing unconfigured projects on first use.

Who it is for — It fits users who need to run project checks before and after tool execution and when a turn tries to finish, as well as project initialization on first use. Users who avoid network access and project write permissions during setup can choose not to install it.

Watch out — Initial setup requires network access and project write access. It executes shell commands. Sandbox testing has not been performed, no obvious pitfalls found.

The verdict — I won't install it because it requires network access and project write access during initial setup and has no sandbox testing.

Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.Read the source
1Source
386

Manages local DeepSeek Harness skills in Settings and shows shared Agent skills as read-only.

Installed cleanly when we ran it

npm packageJavaScript19d ago

AI review

dsh-skills-manager

What it is — Manages local DeepSeek Harness skills in Settings and displays shared Agent skills as read-only.

Who it is for — Users who need to manage local and project skills across multiple tools in DeepSeek Harness setups would use this plugin. Users who only rely on shared agent skills without local or project management do not need it.

Watch out — Passed sandbox test: installed in a new profile and registered by Harness. No obvious issues found. Compatible with DeepSeek Harness 0.2.x series.

The verdict — I would install it because it supports incremental updates from public GitHub repositories with backup restoration.

Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.Read the source
Details

oh-dsh

hust-open-atom-club

323

Community distribution: TUI, desktop, and Web UI as one bundle with layered installation.

GitHub sourceTypeScript2mo ago

pi2dsh

weijiafu14

212

Pi Host ABI compatibility engine: after one install, unmodified Pi extensions from npm mount as native DSH plugins with `dsh plugin add <pi-package>`. Verified end to end on stock DSH with pi-mcp-adapter (full MCP manager: OAuth, resources, prompts, MCP Apps, elicitation, sampling), @tintinweb/pi-subagents, pi-code, pi-hermes-memory and pi-background-tasks; `pi2dsh inspect` reports a package's compatibility before installing.

DeepSeek Harness 0.2.2-rc.1 refuses the latest release

npm packageTypeScript21d ago

AI review

pi2dsh

What it is — pi2dsh is a Pi host ABI compatibility engine that mounts unmodified Pi npm packages as native DSH plugins on DeepSeek Harness.

Who it is for — Pi plugin developers who want to run their npm packages unmodified on DeepSeek Harness should install it. Developers who are not involved in Pi plugin development do not need to install it.

Watch out — It was tested successfully in a new profile and registered into the profile. A restart of DeepSeek Harness is required. Installation may require manually approving build scripts if pnpm blocks them.

The verdict — I would install it if I need Pi ecosystem plugins on DeepSeek Harness because it provides unmodified compatibility.

Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.Read the source
1Source
202

Manages DSH skills and MCP servers from the web settings: skill cards with hot enable/disable, workspace scopes, groups, batch migration and drag-and-drop import, plus stdio/HTTP MCP CRUD with connection tests, secret redaction and the unified dsh-panel CLI.

Installed cleanly when we ran it

npm packageJavaScript1mo ago

AI review

dsh-skill-mcp-panel

What it is — DSH plugin that adds skill and MCP management panels to Web settings and provides unified dsh-panel CLI. Supports hot enable/disable, batch migration, drag-and-drop add, scoped operations, and CRUD for stdio/HTTP MCP servers.

Who it is for — If you are developing skills or configuring custom MCP servers in a DeepSeek Harness profile, this lets you handle everything directly in the settings page; if you only use built-in tools without needing extra panels or CLI subcommands, you do not need to install it.

Watch out — Installation from source requires manually enabling the build script. Sandbox testing passed with no other obvious issues found.

The verdict — Install if you need skill and MCP management integration; otherwise it is not worth it. The premise is that your profile involves more than just built-in tools.

Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.Read the source
1Source