{"id":"paseo-display-switcher","repo":"nerveband/paseo-display-switcher","url":"https://github.com/nerveband/paseo-display-switcher","name":"paseo-display-switcher","description":"A [Paseo](https://paseo.sh) plugin that lets you toggle and switch sidebar display modes (Project listing vs. Status listing) via keyboard shortcuts and the Command Center (`⌘K` / `Ctrl+K`).","categories":["productivity","other"],"platforms":[],"caveats":[],"images":[],"themes":[],"health":{"manifestValid":true,"hasReadme":true,"hasLicense":true,"hasTests":false,"hasTypecheckScript":true,"updatedRecently":true},"scannedAt":"2026-10-15T12:31:26.335Z","addedAt":"2026-09-10T18:09:18+03:00","version":"0.0.0","security":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-10-15T12:14:24.405Z","commit":"2d47ca7af1d672e257d1daa4909c7fbfb3e46fd8"},"scanError":"package.json version \"0.0.0\" is a placeholder; publish a real release version","license":"MIT","paseoVersionRequirement":">=0.8.0","descriptionNodes":[{"type":"text","text":"A "},{"type":"link","href":"https://paseo.sh","children":[{"type":"text","text":"Paseo"}]},{"type":"text","text":" plugin that lets you toggle and switch sidebar display modes (Project listing vs. Status listing) via keyboard shortcuts and the Command Center ("},{"type":"text","text":"⌘K","code":true},{"type":"text","text":" / "},{"type":"text","text":"Ctrl+K","code":true},{"type":"text","text":")."}],"caveatNodes":[],"manifest":{"id":"paseo-display-switcher","requirements":{"paseo":">=0.8.0"}},"repoMeta":{"stars":0,"defaultBranch":"main","pushedAt":"2026-09-08T10:46:29Z"},"owner":{"login":"nerveband","avatarUrl":"https://avatars.githubusercontent.com/u/1530727?v=4"},"installNotesHtml":"<p>Install directly from Git:</p>\n<pre><code class=\"language-bash\">paseo plugin add nerveband/paseo-display-switcher\npaseo plugin ls\n</code></pre>\n<p>Check and apply updates:</p>\n<pre><code class=\"language-bash\">paseo plugin status paseo-display-switcher\npaseo plugin update paseo-display-switcher\n</code></pre>\n<p>For local development, clone the repository, run <code>npm install</code> and <code>npm run typecheck</code>, then use <code>paseo plugin install \"$PWD\"</code>.</p>","readmeText":"# Paseo Display Switcher\n\nA [Paseo](https://paseo.sh) plugin that lets you toggle and switch sidebar display modes (Project listing vs. Status listing) via keyboard shortcuts and the Command Center (`⌘K` / `Ctrl+K`).\n\n## Features\n\n- **Keyboard Shortcuts:** Assign custom key combinations (e.g. `Option+P`, `Cmd+Option+1`, `Ctrl+Alt+S`) to toggle or switch display listings directly.\n- **Command Center Actions:** Search and trigger display modes from the Command Center (`⌘K` / `Ctrl+K` -> `Display: Switch to Status Listing`, `Display: Switch to Project Listing`, `Display: Toggle Listing`).\n- **Sidebar Surface:** An in-app configuration surface under the sidebar item to view, record, or clear shortcuts.\n- **Accurate State Grounding:** Reads and verifies against Paseo's persisted sidebar view store (`sidebar-view`), avoiding race conditions and redundant menu cycles.\n\n## Requirements\n\n- Paseo daemon (0.5.0+) with `pluginsEnabled: true` in `~/.paseo/config.json`.\n- Node.js 18+.\n\n## Installation\n\nInstall directly from Git:\n\n```bash\npaseo plugin add nerveband/paseo-display-switcher\npaseo plugin ls\n```\n\nCheck and apply updates:\n\n```bash\npaseo plugin status paseo-display-switcher\npaseo plugin update paseo-display-switcher\n```\n\nFor local development, clone the repository, run `npm install` and `npm run typecheck`, then use `paseo plugin install \"$PWD\"`.\n\n## Usage\n\n### 1. Command Center\nPress **`⌘K`** (macOS) or **`Ctrl+K`** (Linux/Windows) anywhere in Paseo and type:\n- `status` -> **`Display: Switch to Status Listing`**\n- `project` -> **`Display: Switch to Project Listing`**\n- `toggle` -> **`Display: Toggle Listing (Project / Status)`**\n\n### 2. Keyboard Shortcuts\n- Open **Display Switcher** from the sidebar.\n- Click **Record** on any action and press your desired key combination.\n- Click **Remove** to unbind any shortcut.\n- Toggle the **Enabled / Disabled** switch to enable or disable global shortcut capture.\n\n## Development\n\n```bash\nnpm run typecheck                           # TypeScript verification\npaseo plugin reload paseo-display-switcher  # Apply changes live\npaseo plugin logs paseo-display-switcher    # Inspect plugin output\n```\n\n## License\n\n[MIT](LICENSE)\n"}