3745a13eaf
Phase 1-2 complete: Database schema + 9 MCP tools for session docs Database Changes (migration 016): - session_notes table (accomplishments, decisions, gotchas, etc.) - session_plans table (plan mode plans with lifecycle tracking) - project_documentation table (persistent project docs) - sessions.documentation column (auto-generated markdown) - HNSW indexes for semantic search across all doc types MCP Tools Added (session-docs.ts): 1. session_note_add - Add structured notes to session 2. session_notes_list - List notes by type 3. session_plan_save - Save plan with embedding 4. session_plan_update_status - Track plan lifecycle 5. session_plan_list - List session plans 6. project_doc_upsert - Create/update project docs 7. project_doc_get - Get specific doc by type 8. project_doc_list - List all project docs 9. session_documentation_generate - Auto-generate markdown Replaces: CLAUDE.md files, ~/.claude/plans/ directory Next: Update session-start/end scripts for temp file management Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Task MCP Server
Exposes task management tools via Model Context Protocol. Uses PostgreSQL with pgvector for semantic search.
Requirements
- SSH tunnel to services:
ssh -L 5432:localhost:5432 services -N & - PostgreSQL with pgvector on services (CI stack
postgrescontainer) - CI postgres must be running:
ssh services "cd /opt/docker/ci && docker compose up -d postgres"
Configuration
Add to ~/.claude/settings.json under mcpServers:
{
"task-mcp": {
"command": "node",
"args": ["/path/to/task-mcp/dist/index.js"],
"env": {
"DB_HOST": "localhost",
"DB_PORT": "5432",
"DB_NAME": "agiliton",
"DB_USER": "agiliton",
"DB_PASSWORD": "<from /opt/docker/ci/.env>",
"LLM_API_URL": "https://llm.agiliton.cloud",
"LLM_API_KEY": "sk-master-..."
}
}
}
Tools
| Tool | Description |
|---|---|
task_add |
Create task with auto-generated ID and embedding |
task_list |
List tasks with filters (project, status, type, priority) |
task_show |
Show task details including checklist and dependencies |
task_close |
Mark task as completed |
task_update |
Update task fields |
task_similar |
Find semantically similar tasks using pgvector |
task_context |
Get related tasks for current work context |
task_link |
Create dependency between tasks |
task_checklist_add |
Add checklist item to task |
task_checklist_toggle |
Toggle checklist item |
Build
npm install
npm run build
Development
npm run dev # Run with tsx (no build)