Repository navigation
Conversation
Signed-off-by: Weiming Liao <liaowm5@gmail.com>
Signed-off-by: Weiming Liao <liaowm5@gmail.com>
FayeSpica
marked this pull request as ready for review
November 18, 2026 11:45
FayeSpica
requested review from
hsliuustc0106 and
princepride
as code owners
November 18, 2026 11:45
Signed-off-by: Weiming Liao <liaowm5@gmail.com>
github-actions
Bot
requested review from
Probiotics5333,
allendyu and
wuzhf9
November 18, 2026 11:47
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Add an Electron application with bundled Python, FFmpeg and Agent runtime, reusing the existing Web UI and project services. The shell owns an authenticated dynamic-port Host, preserves work when the window is hidden, and checks active tasks before quitting.
On macOS, integrate window controls into the toolbar and add a collapsible native-vibrancy project sidebar. The new-project action appears in the sidebar when expanded and beside the sidebar toggle when collapsed. Include terminal-command installation, bilingual UI and build documentation.
For macOS arm64, the release workflow builds an unsigned DMG, smoke-tests the app from the mounted disk image, and attaches the DMG and its SHA-256 checksum to a draft GitHub release. It runs on version tags or by manual dispatch.
Linked issue
Refs #363. Developer ID signing, notarization, and updates remain separate work.
Labels
type:feat,area:desktop,area:ciTest plan
Reproduction commands
npm testPYTHONPATH=packages/core/src:apps/api/src python -m pytest tests/test_desktop_host.py tests/test_creation_api.py -qOPENDIRECTOR_DESKTOP_RUNTIME="$PWD/apps/desktop/runtime" npm test --prefix apps/desktopnpm run buildnpm run check:i18nactionlint .github/workflows/desktop-release.ymluvx --from pre-commit==4.5.1 pre-commit run --from-ref upstream/main --to-ref HEADnode apps/desktop/scripts/smoke.mjs apps/desktop/build/mac-arm64/OpenDirector.app/Contents/MacOS/OpenDirectorPrepare the bundled runtime and application using
docs/development/desktop.mdbefore packaged checks.Test result
Validation of
ae2e3d3con macOS arm64:actionlintpassed forb58ae368. The GitHub Actions release run is pending.ae2e3d3c.Keep this PR draft. Clean-machine Agent-assisted creation, editing, export, recovery and other platforms remain unverified. Developer ID signing and notarization are not configured; current builds are not ready for public distribution.
Evidence that it works
English desktop screenshots from a local build.
App

Sidebar collapsed
Sidebar expanded
Provider verification
Bilingual UI
zh-CNanden-US.