Files

Jason Woltje 632b8fb2d2 fix: address code review feedback

- Fix incorrect API endpoint paths (removed /api prefix)
- Improve TypeScript strict typing with explicit metadata interfaces
- Update SKILL.md with clear trigger phrases and examples
- Fix README installation path reference
- Add clarification about API URL format (no /api suffix needed)
- Export new metadata type interfaces

2026-01-29 21:23:36 -06:00

2.2 KiB

Raw Blame History

Mosaic Stack Gantt Plugin

Clawdbot skill for querying and analyzing project timelines, task dependencies, and schedules from Mosaic Stack's Gantt/Project API.

Features

Query project timelines and task lists
Check task dependencies and blocking relationships
Get project status overviews with statistics
Identify critical path items in projects
PDA-friendly language (supportive, non-judgmental)

Installation

Copy skill to Clawdbot plugins directory:

cp -r ~/src/mosaic-stack-worktrees/feature-26-gantt-skill/packages/skills/gantt ~/.claude/plugins/mosaic-plugin-gantt

Set up environment variables:

Add to your .env or shell profile:

export MOSAIC_API_URL="http://localhost:3000"
export MOSAIC_WORKSPACE_ID="your-workspace-uuid"
export MOSAIC_API_TOKEN="your-api-token"

Verify installation:

~/.claude/plugins/mosaic-plugin-gantt/gantt-api.sh projects

Usage

Via Clawdbot

Once installed, you can ask Clawdbot:

"Show me the timeline for Project Alpha"
"What blocks task 'Implement Auth'?"
"What's the critical path for Q1 release?"
"Show all high-priority tasks due this week"
"Give me a status overview of Project Beta"

Via Command Line

The gantt-api.sh helper script can be used directly:

# List all projects
./gantt-api.sh projects

# Get project details with tasks
./gantt-api.sh project <project-id>

# Get tasks for a project
./gantt-api.sh tasks <project-id>

# Get task details
./gantt-api.sh task <task-id>

# Get dependency chain for a task
./gantt-api.sh dependencies <task-id>

# Calculate critical path for a project
./gantt-api.sh critical-path <project-id>

# Find tasks by status
./gantt-api.sh status IN_PROGRESS
./gantt-api.sh status COMPLETED <project-id>

API Reference

Endpoints

GET /projects - List projects (paginated)
GET /projects/:id - Get project with tasks
GET /tasks - List tasks with filters
- Query params: projectId, status, priority, assigneeId, page, limit

Authentication

All requests require headers:

X-Workspace-Id: Workspace UUID
Authorization: Bearer {token}

License

MIT

2.2 KiB Raw Blame History