Skip to content

humblebanana/dsh-record-replay

70Last commit Aug 13, 2026

dsh-record-replay DSH plugin

The plugin registers the open-record-replay skill and six model-facing orr_* tools. It enables an agent to learn a user-demonstrated desktop workflow by recording real macOS actions, validating the evidence, and packaging it for the host agent's native skill creator.

How to install the dsh-record-replay DSH plugin

dsh plugin --profile web add ./dsh-record-replay-0.1.0.tgz

Copying does not run this command. Review the repository and version before installing the dsh-record-replay DSH plugin.

dsh-record-replay DSH plugin data source

dsh-record-replay DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-record-replay DSH plugin can do

  • Checks macOS Accessibility/Input Monitoring permissions before recording (orr_permissions_check).
  • Starts and stops recording of user's desktop workflow (orr_record_start, orr_record_stop).
  • Reads the recorded events stream (orr_session_events) with a configurable limit.
  • Validates the recording against the official contract (orr_session_validate).
  • Prepares an evidence package for the host skill creator (orr_skill_prepare).
  • Provides a built-in skill creation fallback that generates SKILL.md skeleton and installs to ~/.agents/skills/ (orr_skill_create).

Where the dsh-record-replay DSH plugin fits

  • Record a user-demonstrated macOS workflow so an agent can learn it.
  • Validate the integrity of a recorded session before packaging it as a skill.
  • Package a recorded workflow into a skill-input directory for the host agent's skill creator.
  • Use the built-in skill creation fallback to generate a skill from a recorded session.
  • Integrate user-demonstrated desktop workflows into autonomous agent pipelines.

Who the dsh-record-replay DSH plugin is for

  • Developers building agents with DeepSeek Harness that need to learn from user demonstrations.
  • Users who want to record macOS desktop workflows and convert them into reusable agent skills.

dsh-record-replay DSH plugin limitations

  • Only works on macOS (requires Xcode Command Line Tools for the native Swift recorder).
  • Requires Node.js >= 22.19 and a DeepSeek Harness installation.
  • Needs an open-record-replay checkout and manual configuration of the CLI path or repo root.
  • The built-in skill creation is a fallback; host-native Skill Creator is preferred when available.

dsh-record-replay DSH plugin: from the repository README

Quoted from the humblebanana/dsh-record-replay README, the upstream source of the dsh-record-replay DSH plugin. Copyright remains with the original authors.

A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) plugin that turns the [Open Record/Replay](https://github.com/humblebanana/open-record-replay) macOS workflow recorder into first-class harness capabilities. It registers the **`open-record-replay` skill** and **six model-facing `orr_*` tools**, so an agent can learn a user-demonstrated desktop workflow: record the user's real macOS actions, validate the evidence, and package it for the host agent's native skill creator. ```text user demonstrates a workflow -> orr_record_start (capture session.json + events.jsonl) -> orr_record_stop (finalize) -> orr_session_validate (check the evidence against the contract) -> orr_session_events (read what the user actually did) -> orr_skill_prepare (package a skill-input directory) -> host skill creator ``` ## Requirements - macOS (the recorder's native backend is Swift; it needs Xcode Command Line Tools). - Node.js `>= 22.19` (the Harness runtime). - A DeepSeek Harness installation. - An [open-record-replay](https://github.com/humblebanana/open-record-replay) checkout whose `bin/orr.js` the plugin invokes. ##

Read the full READMERepository license: MIT

dsh-record-replay DSH plugin questions

How do I install dsh-record-replay?

Clone the repository, run `pnpm install && pnpm build && pnpm pack`, then use `dsh plugin --profile web add ./dsh-record-replay-0.1.0.tgz` to add it to your profile. The Harness will hot-reload the plugin if the profile is live.

What are the dependencies for this plugin?

You need macOS with Xcode Command Line Tools, Node.js >= 22.19, a DeepSeek Harness installation, and a checkout of the open-record-replay project. The plugin invokes `bin/orr.js` from that checkout.

How do I configure the path to open-record-replay?

You can set the `cliPath` or `repoRoot` config keys, or use the environment variables `ORR_CLI_PATH` or `ORR_REPO_ROOT`. The path is specified in your profile's `cordis.patch.yml` under the `record-replay` row.

Does it work on Windows or Linux?

No, the plugin only works on macOS because the Open Record/Replay recorder uses Swift and requires macOS Accessibility/Input Monitoring permissions.

How do I resolve permission errors when recording?

Use the `orr_permissions_check` tool to verify Accessibility and Input Monitoring permissions. If they are missing, grant the required permissions in System Preferences > Security & Privacy > Privacy.