Ganwan agent dashboard

unlisted

by 知野

Shows a vault operations dashboard with live Codex usage and local knowledge workflow activity.

Updated 1mo ago
View on GitHub

Ganwan Agent Dashboard

An Obsidian desktop dashboard for local knowledge workflows and Codex usage. It renders a native dashboard view from vault data, live Markdown scans, and local Codex session logs.

Install with BRAT

  1. Install and enable BRAT from Obsidian Community Plugins.
  2. Open obsidian://brat?plugin=xiaogan336/ganwan-agent-dashboard, or run BRAT: Add a beta plugin for testing from the command palette.
  3. If using the command, enter xiaogan336/ganwan-agent-dashboard.
  4. Enable Ganwan agent dashboard in Community Plugins, then enable BRAT's startup update check.

BRAT checks GitHub releases and can install future versions without manually copying plugin files.

Files

  • manifest.json: Obsidian plugin manifest.
  • main.js: Plugin logic, view, data provider, heatmap builder, and whitelisted actions.
  • styles.css: Scoped dashboard styles.
  • versions.json: Plugin-to-Obsidian compatibility map.
  • main.test.cjs: Node regression tests for Codex quota and session parsing.

Data sources

  • 00.系统/首页仪表盘/data.json
  • 00.系统/首页仪表盘/dashboard-config.json
  • Live Markdown file scan through Obsidian app.vault.getMarkdownFiles()
  • Local Codex session logs under ~/.codex/sessions

Codex usage is intentionally device-local. Installing the same plugin on two Macs synchronizes the interface version, not each Mac's Codex session history.

Codex session index

The plugin keeps a derived, device-local index at ~/.codex/ganwan-dashboard/session-index-v1.json.

  • The first scan builds the index in a child process so Obsidian remains responsive.
  • Later plugin starts load the index instead of rereading all historical session logs.
  • Growing JSONL files are parsed from their previous byte offset; truncated or replaced files are rebuilt individually.
  • The index contains derived usage summaries and confirmed file-change metadata, not full conversation transcripts.
  • A damaged or incompatible index is ignored and rebuilt automatically.

Commands

  • Open agent dashboard
  • Refresh dashboard data

Safe actions

The plugin only opens configured vault paths and calls fixed local integrations. It does not accept arbitrary shell commands from dashboard input.

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.