Repository navigation
Releases
v2.0.2
Fixed
- The desk server no longer mints a new write token on every start. It reuses
desk/.write-tokenwhen that file is a regular file (not a symlink) owned by the current user, mode 0600, holding exactly 64 lowercase hex characters. A missing file mints a token. A file that fails any check is never trusted: it is replaced with a fresh 0600 token and a warning goes to stderr without the token. Session cookies from before a restart keep working, so the Dock app no longer shows "Move failed" after a restart (#29). dpc start_desk_server --rotateandstart_desk_server rotate=truenow rotate on a fresh start too, after the port bind succeeds. A rotate start that finds the port busy leaves the token file alone. Rotation stays the only way to replace a valid token.- A new
deskdirectory is created with mode 0700. Adeskdirectory that is a symlink or writable by group or others gets a stderr warning. The token file is flushed withfsyncbefore it is renamed into place.
v2.0.1
Added
- Done cards older than 14 days are hidden on the Kanban Done column. Show archived (N) reveals them, muted. The window is
DPC_ARCHIVE_DAYSorarchiveDaysinsecurity-config.json(default 14). Cards are never deleted, andcards.jsongains no archive field. - Optional
noteon a card for a short evidence line (a commit or a URL). Omitted fromcards.jsonwhen empty. Set fromadd_card,update_card, andmove_card. Shown on the board and matched bysearch_desk.
Fixed
- Card writes from the desk page and MCP tools now hold the same
flockon<knowledge base>/.dpc.lockas thedpcwrapper around the whole load, change and save, so a write landing at the same moment as another no longer drops one change. Thedpcwrapper, which holds the lock while it runs this binary, passes its locked descriptor asDPC_LOCK_FD. The binary skips taking the lock only when that descriptor is the same file as.dpc.lockand a fresh handle on the file is refused the lock. The desk server always ignores the variable. A write waits up to 15 seconds for the lock without blocking a thread, then reports an error. The lock file is opened withO_NOFOLLOWandO_CLOEXEC. - A
cards.jsonthat exists but cannot be read or parsed now returns an error to the caller instead of quietly keeping the old board in memory. A missingcards.jsonis an empty board, including one removed while a long-running process holds the old board in memory.
Changed
get_desk_summaryandget_project_statusomit archived cards from lists and report an archived count. PassincludeArchivedto list them.search_deskstill returns archived cards and marks them. Moving a card out of done, or any edit that refreshesupdated, brings it back. The Done in 7 days stat and the analytics tab are unchanged.
Fixed
- Saving
cards.jsonon Linux usesrename(2).FileManager.replaceItemAtfails there even when the file exists, so a second save never landed.
v2.0.0, Dev Project Coordinator
This release renames the project from Claude Project Coordinator to Dev Project Coordinator. The old GitHub URLs redirect. From v2.0.0 the project is licensed under the Apache License 2.0. Earlier releases stay under the MIT licence.
[2.0.0] - 2026-10-31
Licence
- Relicensed from MIT to Apache License 2.0, with a NOTICE file. Earlier releases stay under MIT.
Added
- Multi-language detector (swift, python, javascript, typescript, node, go, rust, ruby, php, java, kotlin, csharp, dotnet, cpp, docker, web, plus spm / xcode-project / xcode-workspace / swiftui from a shallow scan)
- Non-coding project kinds with optional path, including accounting and business
- Analytics tab dashboard: project health gauges, 14-day activity heat map, technology trends, collapsible status timeline, shared with the MCP tools
- Kind-aware health: non-coding projects are not penalised for missing code docs or a tech stack
- Automatic register from working directory and git remote
- Find-or-create, rename, and merge for non-coding work
- Kanban cards and default columns backlog, doing, review, done, parked
- Optional
memoryRefon cards (opaque; DPC never calls a memory service) get_desk_summarywith an 800-token cap- Local Analytics + Kanban HTML page (
open_desk) - Opt-in loopback desk server for drag-and-drop (
127.0.0.1:47821, write token mode 0600, Safari Add to Dock) - Desk logo, favicon, and PWA manifest for a standalone Dock web app
- Kanban cards with kind, PR, and memoryRef chips, relative time, keyboard move, and optimistic drag
dpcexecutable aliasDPC_KNOWLEDGE_BASE(preferred overCPC_KNOWLEDGE_BASE)- Grok Bot paste-in prompt and skill under
docs/grok-bot/
Changed
- Display name is Dev Project Coordinator. MCP server key stays
project-coordinator - Log prefix is
[DPC] add_projectno longer requires a path- Search is
search_desk(search_code_patternsremains as an alias) - Security allowlist honours
security-config.jsonandDPC_ALLOWED_PATHS ~/Desktopis not an allowed root by default (only~/Desktop/Development); add it throughsecurity-config.jsonorDPC_ALLOWED_PATHSif you need it- README and Quick Start rewritten for the product
- Desk server uses a fixed port and a one-time sign-in code (
?signin=, valid once, for 10 minutes). The bookmark URL has no token. The write token is long-lived until rotation - Desk subtitle: nothing leaves this machine
Fixed
*-analytics.jsonis not loaded as a project- KnowledgeBase templates are written only when missing
- Swift-only fallback on add is gone
- Quick Start no longer shows
--port 3000 - Desk server rejects an empty, duplicate, or oversized
Content-Lengthwith 400 instead of trapping - Desk server matches the
Content-Lengthheader name exactly (case-insensitive) - Desk server checks Host on every request and rejects a Host header without a port
- Desk server Host/Origin allowlist is IPv4 loopback only (
127.0.0.1andlocalhost) - Desk token file is created 0600; path checks resolve symlinks and drop forbidden roots
- Desk sign-in uses a single-use in-memory code.
?token=is rejected. Callingstart_desk_serverwhile running mints a new code without rotating - Desk responses send
Referrer-Policy: no-referrer. PR chips are https-only withrel="noopener noreferrer"andtarget="_blank" - Invalid
DPC_DESK_PORTlogs a warning and falls back. InvaliddeskPortin security-config is ignored without rewriting the file - The generated project-index.md is no longer tracked in git, so your private project list can't be committed by accident (#20).
Deprecated
CPC_KNOWLEDGE_BASEand theproject-coordinatorserver key. Removal in v3.0
v1.4.2
Maintenance release.
- CI now runs with a read-only token and pinned actions (#13). No changes to the server itself.
v1.4.1
Documentation-only release: removes internal governance references from the repository docs. No code changes.
v1.4.0 - Official MCP SDK modernization
Highlights
- Official Swift MCP SDK
- Security allowlist fix (home directory no longer accepted)
- Stdio-safe logging (stderr only)
- Analytics migrate-once semantics restored
- Real tests + GitHub Actions CI
- README supports Claude Desktop, Cursor, and Claude Code
- Personal analytics scrubbed from the public tree
Upgrade
git pull
swift build -c releasePoint your MCP host at .build/release/project-coordinator and restart it.
Requires Swift 6.0+.
If older installs still show wrong creation dates, run ./scripts/repair-analytics-dates.sh.
Full changelog: https://github.com/M-Pineapple/Claude-Project-Coordinator/blob/main/CHANGELOG.md
v1.3.2 - Critical Analytics Fix
🚨 Critical Bug Fix Release
This release fixes a critical bug that caused analytics data to be re-migrated on every restart, resulting in incorrect project creation dates and loss of timeline accuracy.
What's Fixed
🐛 Analytics Re-Migration Bug (Issue #4)
- Problem: Projects were re-migrated to analytics on every Claude Desktop restart
- Impact: All projects showed today's date as creation date instead of actual creation date
- Solution: Now properly checks for analytics file existence on disk before migration
📅 Date Preservation
- Project creation dates now correctly use file system timestamps
- Historical data is preserved during migration
- Timeline features show accurate project ages
What's New
🔧 Repair Script
For users affected by the date corruption bug:
./scripts/repair-analytics-dates.shThis script will:
- Automatically detect date discrepancies
- Create a backup of your data
- Fix creation dates using macOS file system timestamps
- Preserve all historical data (status changes, activity logs, etc.)
📊 Better Logging
- Added detailed migration logs to track what's happening
- Logs show which projects are migrated vs skipped
- Easier to diagnose issues
Installation
New Users
Follow the standard installation instructions in the README.
Existing Users (Upgrade from v1.3.0/v1.3.1)
- Update your CPC installation
- Run the repair script if your dates are incorrect:
cd /path/to/Claude-Project-Coordinator ./scripts/repair-analytics-dates.sh - Restart Claude Desktop
Technical Details
The fix changes the migration logic in ProjectManager.swift to check for file existence:
let analyticsPath = \"\\(knowledgeBasePath)/projects/\\(project.name)-analytics.json\"
let fileExists = FileManager.default.fileExists(atPath: analyticsPath)
Full Changelog: https://github.com/M-Pineapple/Claude-Project-Coordinator/blob/main/CHANGELOG.md`
}
v1.3.0 - Analytics Release 📊
Analytics Release 📊
This major release introduces comprehensive project analytics to Claude Project Coordinator, providing automatic insights into your development workflow.
✨ Highlights
- Time Tracking - Automatically track time in each project status
- Activity Heat Maps - See which projects are hot 🔥
- Technology Analysis - Understand your tech stack usage
- Health Scoring - Identify projects needing attention
🛠️ New Commands
get_project_timeline- View complete status historyget_activity_heatmap- See project activity levelsget_technology_trends- Analyze framework usageget_project_health- Get health reports
🚀 Quick Start
git pull
swift build -c release
# Update Claude Desktop config with executable path
# Restart Claude DesktopYour existing projects will automatically migrate to include analytics!
📚 Documentation
See [ANALYTICS-EXAMPLES.md] https://github.com/M-Pineapple/Claude-Project-Coordinator/blob/main/ANALYTICS-EXAMPLES.md for real output examples and productive prompts.
Full changelog: https://github.com/M-Pineapple/Claude-Project-Coordinator/compare/v1.2.0...v1.3.0
v1.1.0 - Portable Installation & Bug Fixes
🐛 Bug Fixes
This release fixes several important issues that improve installation and reliability:
Fixed
- Portable Installation - Fixed hardcoded path issue by using relative path construction from executable location. The tool now works correctly regardless of where it's installed
- JSON Date Decoding - Fixed error when loading existing projects by adding ISO8601 date decoding strategy
- Build Script Arguments - Removed unnecessary port configuration from build script
- EXAMPLE File Loading - Added exclusion for EXAMPLE files to prevent loading template files as real projects
Changed
- Knowledge base path is now constructed relative to the executable location, making the tool truly portable
- Project loading now properly handles date formats in existing project files
- Build script now provides correct MCP configuration without port arguments
Technical Details
ProjectManager.swift: Dynamic path construction usingBundle.main.executablePathProjectManager.swift: Addeddecoder.dateDecodingStrategy = .iso8601inloadProjects()ProjectManager.swift: Added&& !file.contains("EXAMPLE")filterscripts/build.sh: Updated to use"args": []instead of["--port", "3000"]
📦 Installation
# Clone the repository
git clone https://github.com/M-Pineapple/Claude-Project-Coordinator.git
cd Claude-Project-Coordinator
# Build the project
./scripts/build.shInitial Alpha Release - MCP for Xcode/Swift Projects
🍍 Claude Project Coordinator v0.1.0-alpha
Initial alpha release of the Swift-based MCP server for managing Xcode projects.
✨ Features
- Track multiple Xcode projects
- Search code patterns across projects
- Maintain development knowledge base
- Auto-detect Swift/SwiftUI patterns
📦 Installation
git clone https://github.com/M-Pineapple/Claude-Project-Coordinator
cd Claude-Project-Coordinator
./scripts/build.sh
