pikaboard

What This Skill Does

The PikaBoard skill integrates OpenClaw agents directly with the PikaBoard task management system. It acts as an agent-first kanban dashboard, turning the agent into a self-managing entity that can track its own progress, prioritize incoming requests, and maintain a source of truth for its workflow. By utilizing this skill, agents can move tasks between statuses like 'inbox', 'in_progress', and 'done', query backlogs, and organize work into dedicated boards per agent profile. It effectively bridges the gap between raw task execution and structured project management.

Installation

To integrate PikaBoard into your environment, first navigate to the skill repository. Execute the installation command: clawhub install openclaw/skills/skills/angelstreet/pikaboard. After installation, ensure your backend server is running via npm start within the pikaboard/backend directory. Configure your environment by creating a backend/.env file with your PIKABOARD_TOKEN and database path. Finally, ensure your shell environment exports PIKABOARD_API, PIKABOARD_TOKEN, and AGENT_NAME to allow the agent to authenticate and communicate with the PikaBoard API effectively. You can automate board mapping using the provided setup-agent-board.sh script.

Use Cases

• Autonomous Workflow Management: An agent automatically promotes a 'Fix bug' task from the backlog to 'in_progress' once it begins work.
• Multi-Agent Coordination: Separate boards for distinct team agents (e.g., Pika for main tasks, Bulbi for technical maintenance) allow for specialized workflows while remaining on a unified platform.
• Sprint Planning: Agents can list 'up_next' items to determine their high-priority tasks for the day, ensuring consistent output based on the defined kanban stages.

Example Prompts

1. "PikaBoard, list all my tasks currently in the 'up_next' status for board ID 6."
2. "I've finished the authentication module, please move task #42 to 'in_review' in the PikaBoard dashboard."
3. "Create a new urgent task in the backlog called 'Optimize database queries' with the tags 'performance' and 'backend'."

Tips & Limitations

• Source of Truth: Always treat PikaBoard as the authoritative source for task status. Avoid manual overrides if the agent has configured automation rules.
• Board Mapping: Use the setup-agent-board.sh helper to avoid manual board ID lookups; it creates boards on the fly if they are missing for a specific agent name.
• Limitations: This skill requires an active local backend server. Ensure network visibility between the OpenClaw agent and the API port (default 3001). For security, ensure the PIKABOARD_TOKEN is rotated periodically.