
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.tgzCopying 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.