Shrimp Task Manager

The test suite is organized into four main categories:

1. Server Tests (test/server.test.js): Validates the Node.js HTTP server, including settings management, API endpoints (/api/agents, /api/add-profile, /api/remove-profile/:id, /api/tasks/:agentId), static file serving, and error handling.
2. Component Tests (src/test/): React component tests for App, TaskTable, and TaskDetailView covering rendering, user interactions, and state handling.
3. Integration Tests (test/integration.test.js): Validates full application workflows, such as profile switching and search/filtering across profiles.
4. Edge Cases (test/edge-cases.test.js): Tests network errors, data integrity (XSS, Unicode), state management (rapid switching), and performance (large datasets).

The Shrimp Task Viewer is a React-based web interface for visualizing and managing tasks created via the Shrimp Task Manager MCP tool. It provides a visual overview of task status, dependencies, and progress, and facilitates interaction with AI agents by providing easy ways to copy task UUIDs and execution instructions.

Key capabilities include:

• Visual Overview: View tasks in a clean tabbed interface with status badges (🟡 Pending, 🔵 In Progress, 🟢 Completed, 🔴 Blocked).
• UUID Management: Click task badges to copy UUIDs for manual AI agent commands.
• Parallel Execution: Use the AI Action column (🤖) to copy specific instructions for multiple agents simultaneously.
• Live Updates: Direct file path reading ensures the UI reflects the current task status.
• Multi-Project Support: Manage tasks across different projects using draggable profile tabs.

The Shrimp Task Viewer provides a visual interface for managing tasks. Recent major features include:

• Direct File Path Support: Instead of uploading files, you can enter a directory path directly for live updates.
• Documentation & Release Notes: Dedicated tabs for Markdown-rendered documentation and in-app release notes (with image support).
• Task Navigation: Clickable dependencies to navigate between related tasks.
• AI Integration: An 'AI Actions' column allows you to copy instructions for AI agents to complete tasks.
• UUID Management: Click task badges to copy their UUIDs.
• Profile Editing: Rename profiles and configure project roots.
• Modern UI: Browser-style tabbed interface with drag-and-drop reordering, advanced real-time filtering, and sortable columns.

The Shrimp Task Viewer uses a custom Chakra UI theme designed with a dark-first approach. The theme is organized into several key files:

• index.js: The main theme configuration containing component overrides and semantic tokens.
• colors.js: Contains color constants and utility functions for color management.
• validate.js: Utilities for theme validation and testing.
• README.md: Documentation for the theme.

The theme provides semantic tokens, component style overrides, and utility functions to ensure a consistent UI across the application.

The Task Viewer uses a hybrid approach for data storage to balance stability and real-time accuracy:

• Settings File: Profile configurations (tab names, folder paths, tab order) are stored locally in a hidden JSON file: ~/.shrimp-task-viewer-settings.json. This file is automatically created and updated when you add or modify profiles.
• Task Files: The viewer reads tasks.json files directly from your specified folder paths. It does not upload or copy these files; it simply reads them in real-time, ensuring you always see the current state of your tasks without manual syncing.
• Hot Reload: In development mode, changes to source code trigger automatic rebuilds and browser refreshes for React components, styles, and server code.

Task dependencies are rendered using a specific format and utility:

• Format: Dependencies are displayed in a Task #X format.
• Generation: Task numbers are generated using the taskNumbering utility.
• Navigation: Clicking on a dependency link navigates the user directly to the dependent task.
• Metadata: Hovering over a dependency shows the task's unique identifier (UUID) in a tooltip.
• Edge Cases:
  • If a task reference is invalid, it displays as Unknown Task.
  • If there are no dependencies, it displays as — (em dash).

The Shrimp Task Manager Viewer allows you to edit prompt templates via a web interface, but these changes do not automatically sync to the MCP server for security reasons. The MCP server and the Viewer are separate processes; the MCP server reads configuration once at startup.

Template Storage Locations

• Default Templates: src/prompts/templates_en/ (within the main project).
• Viewer Custom Templates: ~/.shrimp-task-viewer-templates/ (where templates edited via the web UI are stored).
• MCP Server: Prioritizes environment variables to override default locations.

Template Flow

[Web UI Editor] → [~/.shrimp-task-viewer-templates/] → [Export] → [Environment Variables] → [MCP Server]

The Task Viewer uses a hybrid storage model:

1. Profile Configurations (Settings): Stored in a local JSON file at ~/.shrimp-task-viewer-settings.json. This file tracks tab names, folder paths, and tab ordering. It is automatically updated when you add or modify profiles.

2. Task Data (Real-time): The viewer does not upload or store copies of your tasks. It reads tasks.json files directly from the folder paths you provide in your profiles. This ensures the UI always reflects the current state of your data on disk.

3. Git Task History: Task changes are automatically tracked in a separate Git repository located at <shrimp-data-directory>/.git. This allows for auditing and recovery without interfering with your main project's Git history.