v1.15.0 — Summary Layer for Tasks & Note History

What's New

Summary Layer — Tasks and archived notes now support a one-sentence summary field that serves as a quick table-of-contents entry.

Task Summaries

• New summary parameter on aidex_task create/update
• aidex_tasks shows summaries inline — scan your backlog without reading full details
• Viewer shows task summaries in italic between title and description

aidex_task({ path: ".", action: "create", 
  title: "Fix parser bug", 
  summary: "Parser crashes on nested generics in C#",
  priority: 1, tags: "bug" })

Note History Summaries

• New summary parameter on aidex_note when writing/clearing
• The archived note gets this one-sentence description
• History and search show summaries instead of truncated text

aidex_note({ path: ".", note: "New session focus",
  summary: "Previous session: finished parser refactoring" })

Auto-Migration

• Existing databases are automatically upgraded via ALTER TABLE ADD COLUMN — no manual steps needed
• Backward compatible: entries without summaries show null / fallback preview

npm: npm install -g aidex-mcp@1.15.0
Full changelog: CHANGELOG.md

v1.14.0 — AI Guidelines, Security Fixes, Viewer Improvements

What's New

Added

• aidex_global_guideline — Persistent key-value store for AI guidelines and coding conventions. Store named instructions like "review" → review checklist, "release-prep" → release steps. Actions: set, get, list, delete. Works without prior global_init.
• Viewer file size limit: getFileContent() now refuses files larger than 1 MB — prevents browser from freezing on large binary or generated files

Fixed

• Command injection in Linux screenshot tools: All execSync calls with shell string interpolation replaced with execFileSync using argument arrays
• Global query cache grows unbounded: Cache entries evicted on write when they exceed the 5-minute TTL — prevents memory leak in long-running sessions
• Viewer race condition on file change: pendingChanges set is now snapshotted and cleared before processing
• Viewer buildTree() N+1 queries: Correlated subqueries replaced with LEFT JOIN — single query instead of one subquery per file
• WebSocket unknown message type: Viewer now sends an error response for unrecognized message types
• Viewer taskId not validated: updateTaskStatus now checks Number.isInteger(taskId) before processing
• Viewer mode not whitelisted: getTree message mode constrained to 'code' | 'all'
• getProjects() SQL injection via tag/namePattern: escapeLikeTerm() now applied to both filter parameters
• Silent fails in viewer and global DB: catch {} blocks now log errors via console.error
• Git status refresh on every file event: Added 5-second minimum interval between git status refreshes
• Global query cache not invalidated after init/update: aidex_init and aidex_update now call invalidateGlobalCache()

Refactored

• screenshot/shared.ts: New module with centralized hasTool() and runPowerShell() — both use execFileSync (no shell)
• normalizePath(): Private duplicates removed — both now import from commands/shared.ts
• escapeLikeTerm(): Exported from commands/shared.ts and used consistently across all LIKE queries
• macOS sips output parsing: Replaced shell pipe with regex on direct sips output

v1.14.1 — Docs, README, Package Cleanup

What's New

Changed

• aidex_global_guideline fully documented: Added to README (overview table, TOC, AI instructions block), MCP API Reference, and aidex setup instructions
• README: Tool count updated to 29, aidex_global_signatures parameter corrected (term not name), Guidelines row added to overview table
• Package cleanup: Internal planning/review docs excluded from npm package and git

v1.13.0 — Screenshot Optimization (95% smaller)

Screenshots — LLM-Optimized

New scale and colors parameters for aidex_screenshot reduce file size up to 95% for LLM context.

The numbers

	Raw Screenshot	Optimized (scale=0.5, colors=2)
File size	~100-500 KB	~5-15 KB
Tokens consumed	~5,000-25,000	~250-750
Text readable?	Yes	Yes

New parameters

Parameter	Values	Description
scale	0.1 - 1.0	Scale factor (0.5 = half resolution)
colors	2, 4, 16, 256	Color reduction (2 = B&W, ideal for text)

AI auto-optimization

The tool description guides AI assistants to optimize automatically:

1. Start with scale: 0.5, colors: 2 (smallest possible)
2. If unreadable, retry with colors: 16
3. If still unclear, scale: 0.75 or full color
4. Remember what works per app during the session

Cross-platform

Windows (PowerShell + System.Drawing), macOS (sips + ImageMagick), Linux (ImageMagick)

---

Also includes v1.11.0 and v1.12.x changes since last release:

• Global Search (v1.11.0): Search across ALL projects — 5 new tools (global_init, global_query, global_signatures, global_status, global_refresh)
• Zero-Config Setup (v1.12.0): npm install -g aidex-mcp auto-registers with Claude, Cursor, Windsurf, Gemini CLI, VS Code Copilot
• Update Notifications (v1.12.1): aidex_session shows "What's New" after updates

Full changelog: https://github.com/CSCSoftware/AiDex/blob/master/CHANGELOG.md

npm install -g aidex-mcp

v1.12.1 — Update Notifications

What's New

Update notifications in session start: When AiDex is updated, aidex_session now shows a "What's New" section with release highlights — once per version, then silently stored.

## 🎉 Updated: v1.11.0 → v1.12.0

- Auto-setup on install — no more manual "aidex setup" needed
- Comprehensive AI instructions for all 27 tools
- Code refactoring + DB fixes

Full changelog: https://github.com/CSCSoftware/AiDex/blob/master/CHANGELOG.md

No action needed — users see this automatically on their next session after updating.

v1.12.0 — Auto-Setup, Comprehensive AI Instructions, Refactoring

What's New

Auto-Setup on Install

npm install -g aidex-mcp now automatically registers AiDex with all detected AI clients (Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI, VS Code Copilot) and installs AI instruction files (CLAUDE.md, GEMINI.md). No more manual aidex setup needed.

• Opt-out: AIDEX_NO_SETUP=1 npm install -g aidex-mcp or CI env var
• Graceful fallback if auto-setup fails

Comprehensive AI Instructions

The instruction block installed by aidex setup now covers all 27 tools with:

• Decision tree: .aidex/ exists → STOP, use AiDex instead of Grep
• Explicit ❌/✅ examples
• Search modes explained (exact/contains/starts_with)
• Session notes, task backlog, global search, screenshots — all with examples
• Duplicate detection: won't add a second block if manual AiDex instructions exist

Code Refactoring

• Extracted shared utilities (shared.ts, global-shared.ts) — ~200 lines of boilerplate eliminated across 10 command files
• DB fixes: transactions for bulk operations, N+1→batch query, stats 7→1 query
• SQL injection fix in global-signatures.ts

Full Changelog: https://github.com/CSCSoftware/AiDex/blob/master/CHANGELOG.md

v1.10.0 - Note History

What's New

Note History (v1.10.0)

Session notes are now automatically archived when overwritten or cleared. Browse and search past notes across sessions.

New parameters for aidex_note:

• history: true — Show archived notes (newest first)
• search: "term" — Search note history (case-insensitive)
• limit: N — Max entries to return (default: 20)

Example:
```
aidex_note({ path: ".", history: true }) # Browse history
aidex_note({ path: ".", search: "glob fix" }) # Search history
```

Auto-migration: Existing databases are upgraded automatically on first use — no manual steps needed.

v1.8.0 - Task Backlog, Code Review & npm Publish

What's New

Task Backlog (v1.8.0)

Built-in project task management persisted in AiDex database:

• aidex_task - Create, read, update, delete tasks with priority, tags, and descriptions
• aidex_tasks - List and filter tasks by status, priority, or tag
• Auto-logging: Status changes and task creation are automatically recorded
• Manual log entries: Add notes to any task with the log action
• Viewer Tasks Tab: Interactive task management in the browser viewer
• Priorities: 🔴 high, 🟡 medium, ⚪ low
• Statuses: backlog → active → done | cancelled

Code Review Phase 1

26 fixes across security, bugs, parser and refactoring:

• Security: Path traversal protection, glob injection prevention, sanitized viewer HTML output
• Parser fixes: Arrow function name extraction, Python docstring handling, TSX grammar, abstract class support, C duplicate method fix
• Bug fixes: Proper error handling, fixed file exclusion in aidex_update
• Refactoring: Extracted shared glob utility, improved signature formatting

npm & Registry

• Published as aidex-mcp on npm
• Registered in the Official MCP Registry
• Install: npm install -g aidex-mcp

Install

npm install -g aidex-mcp
aidex setup

Full changelog: https://github.com/CSCSoftware/AiDex/blob/master/CHANGELOG.md

v1.7.0 - Gemini CLI & VS Code Copilot Support

Added

• Gemini CLI support: aidex setup detects and registers AiDex with Gemini CLI (~/.gemini/settings.json)
• VS Code Copilot support: aidex setup detects and registers AiDex with VS Code (mcp.json with "servers" key and "type": "stdio")
• GEMINI.md instructions: Auto-installs AI usage instructions in ~/.gemini/GEMINI.md (alongside existing CLAUDE.md support)

Supported Clients

Client	Registration	AI Instructions
Claude Code	CLI	CLAUDE.md
Claude Desktop	JSON	CLAUDE.md
Cursor	JSON	-
Windsurf	JSON	-
Gemini CLI	JSON	GEMINI.md
VS Code Copilot	JSON	-

Install

npm install -g aidex-mcp
aidex setup

v1.6.1 - Version & Setup Fixes

Fixed

• MCP Server version: Now reads version dynamically from package.json (was hardcoded to 1.3.0)
• aidex setup for local installs: Detects if aidex is globally available; falls back to node /full/path/index.js when not installed globally

Install

npm install -g aidex-mcp
aidex setup