ModusOp Dock

The missing project manager for Nova.

Adding a new project to Nova used to be painful — clone the repo in Terminal, add it to Sourcetree, then manually open it as a Nova project. Three apps, multiple steps, every single time.

ModusOp Dock fixes this. Browse your GitHub repos right in Nova's sidebar, click to clone, and it's immediately open as a project. One step. One app.

Features

Multi-Repo Dashboard

See all your local repositories in a single sidebar — across all Nova workspaces. Color-coded status icons show you what needs attention at a glance:

• 🟢 Green — clean, up to date
• 🟠 Orange — uncommitted changes
• 🔵 Blue — unpushed commits (needs push)
• 🔴 Red — behind remote (needs pull)
• 🟣 Purple — diverged (ahead and behind)

Plus text badges with exact counts: ▲3 commits to push, ▼1 to pull, ✱7 uncommitted files.

One-Click Clone & Open

Browse all repos from your GitHub account in the GitHub tab. See a repo you need? Double-click it — Dock clones it to your repos folder and opens it in Nova as a project. Done.

No Terminal. No Sourcetree. No manual project setup.

Custom Folders

Organize repos into collapsible folders — Clients, Internal, Plugins, whatever makes sense. Right-click any repo to move it, or select multiple repos and move them together. Folders persist across restarts.

Right-Click Actions

Every repo has a full context menu:
- Open in Nova — switch to any project instantly
- Pull / Push — git operations without leaving Nova
- Open in GitHub — jump to the repo in your browser
- Move to Folder — organize into custom groups
- Clone — for remote repos in the GitHub tab

GitHub Integration

Connects to your GitHub account (personal or organization) and shows all your repos — including private ones. The Local tab shows what's on your machine, the GitHub tab shows what's available to clone.

A green ✅ indicator confirms your GitHub connection. Token stored securely in macOS Keychain — never in plaintext.

Settings Backup

Your Nova settings are precious — clips, keybindings, behaviors, preferences. Dock backs them all up to a private GitHub repo automatically.

What gets backed up:
- Clips, key bindings, behaviors, user configuration
- Workspace layouts, server connections, color swatches
- A manifest of all installed extensions (name, version, identifier)

Sync manually with one click, or enable auto-sync on launch. Setting up a new Mac? Clone the backup repo, hit Restore, and your entire Nova environment is back.

Note: Project-specific clips and settings live in each project's .nova/ directory, which is included in your git repo by default. Global settings are what Dock backs up.

Secure by Default

• GitHub token stored in macOS Keychain — never in plaintext, never in config files
• Settings backup pushed to a private GitHub repo
• No external servers, no analytics, no tracking

Setup

1. Set your GitHub username — Open extension preferences → "GitHub Username"
2. Set your repos root — Point "Local Repos Root" to where your repos live (e.g. ~/Sites)
3. Add a GitHub token — Extensions menu → ModusOp Dock → Set GitHub Token. Create a token at github.com/settings/tokens with repo scope.

That's it. Your repos appear in the sidebar, color-coded with git status.

Privacy

All authentication uses your own GitHub token stored in macOS Keychain. Settings backups go to your own private GitHub repo. No data is sent to ModusOp or any third party. Ever.

Roadmap

v1.x — Background polling, drag to reorder, notifications when repos fall behind.
v2.0 — Optional ModusOp integration: client names on repos, retainer status badges, project mapping.

Standalone: everything works without ModusOp. Better with it.

Changelog

Roadmap

v2.0 — ModusOp Integration (optional)

• Show client name alongside each repo (via MO project mappings)
• Retainer status badge per repo
• One-click open client in MO browser
• Core repo management works without MO — integration is opt-in

v1.x — Planned

• Background polling (configurable interval)
• Drag to reorder repos
• Notifications when repos fall behind
• Issue/PR status per repo

1.0.0

• Release version
• All features from 0.x development consolidated

0.8.0

• Auto-discover Nova settings — backs up everything in the support directory automatically
• Installed extensions manifest — generates installed-extensions.json with name, version, identifier for every installed extension
• Future-proof — if Nova adds new settings files, they're picked up automatically

0.7.0

• Fixed settings backup to sync actual Nova files (Clips.json, Behaviors.json, etc.)
• Nova stores clips in Clips.json, not a Clips/ directory

0.6.0

• Custom folders for repo organization — collapsible groups like Sourcetree
• New Folder header button
• Right-click → Move to Folder with multi-select support
• Right-click folder → Rename / Delete
• Folder assignments persist across restarts

0.5.0

• Color-coded status icons: green (clean), orange (dirty), blue (ahead), red (behind), purple (diverged)
• PAT stored securely in macOS Keychain via Set GitHub Token command
• GitHub connection status indicator in sidebar (green ✅ / ⚠️)

0.4.0

• Settings backup: sync Nova settings to a private GitHub repo
• Right-click context menus: Open, Pull, Push, Open in GitHub, Clone
• Uncommitted changes count (✱N) alongside push/pull badges
• Informative tooltips with full status breakdown on hover
• Extension Library preparation: license, homepage, bug reports

0.3.0

• Settings backup feature with Sync Now and Restore commands
• Configurable backup repo name
• Optional sync on launch

0.2.0

• Right-click context menus via contextCommands
• Sidebar icons in proper subfolder structure with metadata.json
• Semver versioning

0.1.0

• Initial release
• GitHub API integration with private repo support
• Local repo scanning with git status badges
• One-click clone and open workflow
• GitHub tab with search/filter
• Manual refresh

MIT License

Copyright (c) 2026 ModusOp

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.