Skip to main content

Overview

profClaw Ops tools let the agent read and write profClaw’s own data: tickets, projects. This means you can ask the agent “create a ticket for this bug” or “what tickets are open in the backend project?” and it will interact with your task board directly. These tools are config-gated - they check for an initialized database at startup and mark themselves unavailable if the storage layer is not initialized.

Tools

create_ticket

Create a new ticket in a project. Security level: moderate | Tier: Standard
projectKey
string
required
Project key prefix (e.g., "PC" for profClaw, "BE" for backend).
title
string
required
Ticket title - a concise description of the work.
description
string
Detailed description with context, acceptance criteria, or steps to reproduce.
type
string
default:"task"
Ticket type: task, bug, story, epic, subtask, feature, improvement.
priority
string
default:"medium"
Priority: critical, high, medium, low, none.
labels
array
String array of labels/tags to apply.
storyPoints
number
Story points estimate for sprint planning.
{
  "projectKey": "PC",
  "title": "Memory search returns stale results after file edit",
  "description": "After editing MEMORY.md, search results still show old content for ~30s",
  "type": "bug",
  "priority": "high",
  "labels": ["memory", "performance"]
}

list_tickets

List tickets with optional filtering. Security level: safe | Tier: Standard
projectKey
string
Filter by project key.
status
string
Filter by status: open, in_progress, review, done, cancelled.
priority
string
Filter by priority.
assignee
string
Filter by assignee ID.
label
string
Filter by label.
limit
number
default:"20"
Maximum tickets to return.

get_ticket

Get full details for a single ticket. Security level: safe | Tier: Standard
ticketId
string
required
Ticket ID (e.g., "PC-42").

update_ticket

Update fields on an existing ticket. Security level: moderate | Tier: Standard
ticketId
string
required
Ticket ID to update.
status
string
New status value.
priority
string
New priority.
title
string
Updated title.
description
string
Updated description.
assigneeId
string
Assign to a user by ID.
labels
array
Replace all labels with this new array.

create_project

Create a new project. Security level: moderate | Tier: Standard
name
string
required
Project name.
key
string
required
2-10 character key prefix used in ticket IDs (e.g., "PC"). Must be unique.
description
string
Project description.
icon
string
Emoji icon for the project (e.g., "rocket").
color
string
Hex color code (e.g., "#6366f1").

list_projects

List all projects. Security level: safe | Tier: Standard Returns all projects with their key, name, description, and ticket counts.

Example Workflow

Ask profClaw in chat:
“We found a bug in the auth flow - tokens aren’t being refreshed. Create a critical bug ticket in the PC project.”
The agent will call create_ticket with the details extracted from your message and return the ticket ID.
“What bugs are currently open in PC with high or critical priority?”
The agent will call list_tickets with the appropriate filters.