Update: run git pull in this folder, then relaunch lancer-kinan-os.cmd. The plugin is updated separately (/plugin), so the badge can stay on "plugin update available" until you do. The dashboard can check for new versions itself (off by default, see config.js).
Kinan dashboard
Français · Website
Demo video (29 s, sound):
https://github.com/user-attachments/assets/07fee2cf-7dc0-4a8d-91d2-3719df02a658
An offline Electron dashboard for the kinan-orchestre Claude Code plugin. It shows, in a small pixel-art office, what the judge (Kinan) and the configured agents are doing, which Claude Code conversations are active, when the next relay is due, and a few local statistics. By default it reads local files only, makes no network connection and calls no model, so it consumes no tokens. Two options change that, only once you enable them: the update check, and the Mail tab (your own mailbox over IMAP/SMTP, summaries and quotes prepared by Claude Code). See "Network".
The plugin writes the state files; this dashboard only displays them. Without the plugin's hooks, the dashboard stays in its idle state.
Status
- Tested on Windows only. macOS and Linux are untested.
- Two separate version numbers: the dashboard (this app, shown as "Dashboard" next to the title) and the kinan-orchestre plugin (shown as "Plugin" below it). They are updated separately and do not have to match. The dashboard is updated with
git pull; the plugin is updated in Claude Code (claude plugin marketplace update kinan, then claude plugin update kinan-orchestre@kinan, then restart Claude Code).
- The interface text is in French.
- Version 0.3.1. Electron 45. Already used by testers on their own computers (first feedback integrated: animation smoothness, taskbar icon, update flow).
- The dashboard displays what the plugin writes. For the judge to work as designed, use Sonnet 5.5 with medium effort in the main Claude chat.
Installation
Requirements: Node.js 20 or later and npm.
npm install
npm start
On Windows, lancer-kinan-os.cmd runs the same two steps.
On Windows the app also (re)creates the Desktop / Start menu shortcut "Kinan Orchestre" at each start (silent, outils/raccourci.ps1), so it exists after a plain git pull and relaunch.
If npm start reports that Electron failed to install (some npm versions skip install scripts), run node node_modules/electron/install.js once, then npm start again.
npm install also installs the three mail libraries used by the optional Mail tab (imapflow, nodemailer, mailparser, pinned versions). They are loaded only after you enable that tab.
Check the network rules statically: npm run verifier (see "Network" below). Run the tests: npm test.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
