diff --git a/data/plugins/ai-project-tracker.yaml b/data/plugins/ai-project-tracker.yaml new file mode 100644 index 0000000..8dcfbd4 --- /dev/null +++ b/data/plugins/ai-project-tracker.yaml @@ -0,0 +1,51 @@ +name: AI Project Tracker +repo: https://github.com/Helixventures-AI/ai-project-tracker +homepage: https://github.com/Helixventures-AI/ai-project-tracker#readme +tagline: Real-time project progress tracker with dashboard, MCP, CLI and git-history import +description: |- + Tracks 7 development phases (research, setup, implementation, testing, docs, deployment, delivery) automatically from tool activity, and shows progress percentages, growth charts, ETA prediction, milestones and a bilingual (EN/FA) HTML dashboard. + + - Zero npm dependencies, 100% local — data lives in the project (.opencode/project-tracker/state.json), nothing is uploaded + - Works beyond opencode: same state engine powers a CLI (pt), an MCP server (Claude Code, Cursor, Copilot, Claude Desktop) and Claude Code hooks + - Git-history import: `pt import-git` backfills all phases from past commits (honest timestamps, no fake growth) + - Notes with phase & weight: `pt note success "..." --phase deploy --weight 3` records retroactive scoring + - Installed via npm (`ai-project-tracker`) or local plugin file +kind: plugin +topics: + - sessions + - code-quality + - git +compat: v2 +scope: + - global + - project +tags: + - progress + - tracking + - dashboard + - mcp + - cli + - productivity +installation: | + ### npm (easiest) + ```bash + npm i -g ai-project-tracker + ``` + + ### opencode + Add to `opencode.json`: + ```json + { + "plugin": ["ai-project-tracker"] + } + ``` + or copy `project-tracker.ts` into `.opencode/plugins/`. + + ### MCP (Claude Code, Cursor, Copilot) + Register `mcp/server.mjs` as a stdio server: + ```json + { "command": "node", "args": ["/mcp/server.mjs"] } + ``` + + ### Claude Code hooks + Point `settings.json` hooks at `hooks/claude-code/pt-hook.mjs` (PostToolUse / SessionStart / UserPromptSubmit / Stop).