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
​
string
required
Project key prefix (e.g., "PC" for profClaw, "BE" for backend).
​
string
required
Ticket title - a concise description of the work.
​
string
Detailed description with context, acceptance criteria, or steps to reproduce.
​
string
default:"task"
Ticket type: task, bug, story, epic, subtask, feature, improvement.
​
string
default:"medium"
Priority: critical, high, medium, low, none.
​
array
String array of labels/tags to apply.
​
number
Story points estimate for sprint planning.

​
list_tickets

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

​
get_ticket

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

​
update_ticket

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

​
create_project

Create a new project. Security level: moderate | Tier: Standard
​
string
required
Project name.
​
string
required
2-10 character key prefix used in ticket IDs (e.g., "PC"). Must be unique.
​
string
Project description.
​
string
Emoji icon for the project (e.g., "rocket").
​
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.

Sessions

Spawn sessions linked to specific tickets for focused work.

Cron Tools

Schedule recurring ticket creation or status checks.