GooodWei/arcana

Arcana

Every slash command in DeepSeek Harness, as a draggable, collapsible, usage-sorted floating command deck.

A floating command deck for DeepSeek Harness, pinned to the right side of the Web UI: it lists every / command the Harness serves — built-in and plugin-provided — as buttons. Hover for details, click to run, sorted by usage, with pagination at 10 commands per page.

✨ Features

• 🔍 Full command discovery — reads the Harness command directory (remote.commands RPC), the exact same catalog the composer's / palette uses, so built-in and third-party plugin commands all appear.
• 🧭 Hover for details — hovering a button shows the command description (identical to the chat-bar hint); argument-taking commands also show their usage hint.
• ⚡ Click to run — argument-free commands run instantly; commands that need input reveal an inline field, Enter to run.
• 🪟 Draggable & collapsible — drag the header to move vertically (position remembered); the "▸/◂" toggle collapses to just the header (like context-vista).
• 📊 Usage-sorted — per-command usage counts are persisted in localStorage, so frequently used commands float to the top across reloads and restarts.
• 📄 10 per page — paginated with prev/next when commands overflow; the list scrolls.
• 🌐 Bilingual — follows the Harness locale.
• 🎨 Client-only, zero build — no host logic, no bundler; themed through the shell's --dsw-* tokens (light/dark aware).

🚀 Install

npx @deepseek-ai/dsh plugin --profile web add github:GooodWei/arcana
npx @deepseek-ai/dsh web

Install pnpm first (dsh plugin add invokes it internally). If dsh is installed globally, npx @deepseek-ai/dsh can be shortened to dsh.

Restart DSH (dsh --profile web) and the deck appears on the right side.

🧭 Usage

• Run: click a command — argument-free commands run immediately; commands with arguments (e.g. /resume-claude) show an inline input.
• Inspect: hover a button for its full description and usage.
• Paginate: use ‹ 1/3 › at the bottom, 10 per page.
• Drag: grab the header to move; position is remembered.
• Collapse/expand: use the "▸/◂" toggle to collapse to just the header.
• Sort: commands are ordered by usage count (descending, then by name); the more you use one, the higher it ranks.

🗂 Layout

package.json          npm metadata + dsh.client manifest
cordis.patch.yml      bundle patch (inserts the host row)
lib/index.js          empty host half (client-only plugin)
lib/client.js         client half: command discovery + floating deck + pagination
README.md / README.en.md   bilingual docs

🛠 Compatibility

• Targets dsh 0.1.0-rc.6 (web profile).
• Client-only; never touches the DSH engine. Consumes only the public remote.commands, sessions, slots, and locale services.

📄 License

MIT