← ClaudeAtlas

alga-psa-project-statuslisted

Reading Alga PSA projects for status reporting: projects by client, status or search; phases; tasks per project or phase; the ordered task status columns (project_status_mapping_id) a project or phase uses; and time logged against project tasks. Covers that the project status filter takes a status UUID, not a name. Read-only.
WYRE-AI/msp-claude-plugins · ★ 55 · AI & Automation · score 84
Install: claude install-skill WYRE-AI/msp-claude-plugins
# Alga PSA Project Status ## Overview MSPs run onboarding, migrations and hardware refreshes as Alga projects. A project lead wants to know which phases are done, which tasks are stuck, and what to tell the client. Every tool here is a read and none is admin-gated in Conduit; moving tasks, changing status or reassigning happens in Alga. ## Key Concepts - **Project** → **phases** → **tasks**. Phases and tasks are not paginated: one call returns them all. - **Task status columns**: `alga_projects_task_status_mappings_list` returns the status columns a project uses, in board order, each with its `project_status_mapping_id`. With `phase_id` you get the phase's own columns, or the project's when the phase has none. Use it to turn a task's mapping ID into a readable status and to know which column is last (done). - **Project status** (the project as a whole) is a separate status list: `alga_statuses_list` with `type` project. ## Common Workflows ### Status report for one project 1. Find it: `alga_projects_list` with `client_id` or `search`, then `alga_projects_get`. 2. `alga_projects_phases_list` with the `project_id`. 3. `alga_projects_task_status_mappings_list` with the `project_id` and each phase's `phase_id` to get that phase's column order and names (a phase without its own columns returns the project's). 4. `alga_projects_tasks_list` with the `project_id` (add `phase_id` for one phase). Bucket tasks by status column. 5. Per phase: tasks done vs tot