Mengshi Cockpit

An all-in-one Obsidian workbench plugin — Calendar, Projects, Todos, Gantt, Feishu (Lark), and Claude Code Sessions in a single interactive dashboard.

A Chinese translation is available at README.zh-CN.md.

Features

🖊 Quick capture: a bottom FAB offers "Diary / Todo" quick entry (not a separate panel).

Demo

Calendar	Gantt

Installation demo: see assets/demo/插件安装.gif.

Installation

From Obsidian Community Plugins (recommended)

1. Open Obsidian → Settings → Community plugins → turn off Restricted mode
2. Community plugins → Browse → search Mengshi Cockpit → Install and enable
3. A shield-shaped icon appears in the ribbon; click it to open the workbench

Manual install (Release)

1. Download the latest main.js, manifest.json, styles.css from Releases
2. Put them into .obsidian/plugins/mengshi-workbench/ in your vault
3. Settings → Community plugins → Enable

Build from source

git clone https://github.com/Spenf710/obsidian-mengshi-cockpit.git
cd obsidian-mengshi-cockpit
npm install
# Build directly into your vault's plugin folder (recommended):
OBSIDIAN_VAULT="C:/path/to/your/vault" npm run build
# Or build to ./dist and copy manually:
npm run build

Output directory priority: OBSIDIAN_VAULT env var → local .obsidian → ./dist.

Setup

The plugin works out of the box, but configure it under Settings → Mengshi Cockpit for the best experience:

Feishu (optional)

The Feishu panel relies on the external lark-cli tool (install and log in yourself):

npm install -g @larksuite/cli
lark-cli auth login

The plugin auto-detects lark-cli (with a npx fallback); a guide is shown when it is missing.

Sessions (optional)

The Sessions panel reads local Claude Code session records (~/.claude/projects/) — no setup needed. "Loop / Open in Claude" requires the Claude Code CLI; buttons show a hint when it is absent.

Privacy & Data

• Everything is processed locally: it reads your vault's .md files, optionally reads ~/.claude/projects session JSONL, and calls Feishu cloud APIs (via lark-cli using your own credentials) only when you open the Feishu panel.
• Nothing is uploaded to third parties: Feishu calls only happen when you perform a panel action (browse / search / stats).
• Settings (including personal overrides) are stored in .obsidian/plugins/mengshi-workbench/data.json.

Development

npm run dev    # watch mode + static file sync
npm run build  # production build

• Source: src/main.ts (plugin shell) + src/data/* (data layer) + src/views/* (view layer)
• Build: esbuild bundle → main.js; standalone styles.css; manifest.json version aligned with the release tag

Platform

Credits & License

• The logo is an original military-style creation with no third-party copyright dependencies.
• Released under the MIT License.