deck-tracker

What This Skill Does

The Deck Tracker skill is a powerful project management extension for OpenClaw that enables direct integration with NextCloud Deck. It functions as a bridge between your AI agent and your kanban boards, allowing you to manage workflows, track progress, and automate task logging without ever leaving your terminal. By utilizing specific environment variables, the agent can connect to your private instance to list, create, update, and monitor tasks in real-time. It follows a structured approach to task management, specifically supporting queues, in-progress states, waiting states, and completion cycles.

Installation

To integrate this skill, use the OpenClaw skill installer. Run the following command in your terminal: clawhub install openclaw/skills/skills/skanderhelali/openclaw-deck-tracker After installation, ensure you have configured your environment variables, specifically DECK_URL, DECK_USER, DECK_PASS, and BOARD_ID. Using an App Password is required for security. If you are using a custom board configuration, override the default stack IDs (1-4) by setting STACK_QUEUE, STACK_PROGRESS, STACK_WAITING, and STACK_DONE accordingly.

Use Cases

This skill is ideal for developers and project managers who need to maintain visibility on their tasks. It is particularly useful for automated daily stand-ups, where a user can dump completed tasks via deck dump-done for memory synthesis. Another key use case is long-running task monitoring; the deck monitor command acts as a background process to keep logs active and notify team members, making it perfect for CI/CD pipeline triggers or heavy refactoring sessions that require regular status updates.

Example Prompts

1. "Check my board and tell me which tasks are currently in the queue, then move the highest priority one to In Progress."
2. "I'm starting on the bug fix titled 'Memory Leak'; please add it to the board in the Progress stack and start a heartbeat monitor for it."
3. "Summarize everything I've finished today and archive the cards once you're done with the daily report."

Tips & Limitations

Always use an App Password rather than your primary NextCloud password for security. Note that the heartbeat monitoring feature is intended for tasks lasting over 2 minutes; running it on shorter tasks may result in excessive logging. If the agent loses connection, ensure the DECK_URL points to the exact API path provided in your NextCloud Deck instance settings. The tool is highly dependent on correct board IDs; double-check these in your dashboard if commands fail to locate specific cards.