Documentation
Go back

Ticket-Mate Setup Guide

Complete setup guide to get cursor.automation workflow running.

Quick Start

bash
# 1. Setup cursor-only board
tm setup-board -p NOVA

# 2. Test workflow
tm test-workflow -p NOVA

# 3. Create a ticket
tm create -p NOVA -t "My first ticket" -u cursor.automation

# 4. Check API report
cat .orchestrator/api-report.md

Step-by-Step Setup

Step 1: Environment Configuration

Create .env file:

env
# Jira Configuration
ATLASSIAN_BASE_URL=https://pamcms.atlassian.net
ATLASSIAN_EMAIL=your-email@example.com
ATLASSIAN_API_KEY=your-api-token
ATLASSIAN_PROJECT_KEY=NOVA

# Auto-Work Configuration
ATLASSIAN_AUTO_WORK_ASSIGNEE=cursor.automation

# Webhook Security
ATLASSIAN_TM_WEBHOOK_SECRET=your-webhook-secret

# Orchestrator Configuration
ORCHESTRATOR_BASE_URL=http://localhost:7777
ORCHESTRATOR_API_KEY=your-api-key
ORCHESTRATOR_ENABLED=true

Step 2: Setup Cursor-Only Board

bash
# Create board filtered to cursor.automation tickets
tm setup-board -p NOVA

This creates:

  • Kanban board: "Cursor Automation"
  • JQL filter: project = NOVA AND assignee = "cursor.automation"
  • Columns: Plan, In Progress, AI: In Progress, In Review, Done

Step 3: Configure Jira Webhook

  1. Go to Jira Settings → System → Webhooks
  2. Click Create a webhook
  3. Configure:
    • Name: Ticket-Mate Workflow
    • URL: https://your-domain.com/api/webhooks/jira
    • Status: Active
    • Events:
      • ✅ Issue created
      • ✅ Issue updated
  4. Copy webhook secret to .env as ATLASSIAN_TM_WEBHOOK_SECRET

Step 4: Test the Pipeline

bash
# Run workflow test
tm test-workflow -p NOVA

# Create a test ticket
tm create -p NOVA -t "Test workflow" -u cursor.automation

# Check if it worked
cat .orchestrator/api-report.md

Step 5: Verify Workflow

  1. Check Board: Go to Jira and verify "Cursor Automation" board exists
  2. Check Ticket: Verify ticket was created and assigned
  3. Check Progress: Verify .orchestrator/ files were created
  4. Check Report: Review api-report.md for any failures

Workflow Pipeline

┌─────────────┐
│   Plan      │  ← Tickets planned here
└──────┬──────┘
       │
       ▼
┌─────────────┐
│ In Progress │  ← Manual or auto-assignment
└──────┬──────┘
       │
       ▼
┌─────────────┐
│AI: In Progress│ ← Cursor working (same status, different column)
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  Orchestrator│ ← Automated workflow
└──────┬──────┘
       │
       ▼
┌─────────────┐
│ In Review   │  ← Code review
└──────┬──────┘
       │
       ▼
┌─────────────┐
│    Done     │  ← Completed
└─────────────┘

Commands Reference

Daily Commands

bash
# Create ticket for cursor
tm create -p NOVA -t "Task name" -u cursor.automation

# List cursor tickets
tm ls-tickets -p NOVA -a cursor.automation

# Move ticket to Plan
tm plan -t NOVA-123

# Test workflow
tm test-workflow -p NOVA

Setup Commands

bash
# Setup board (one time)
tm setup-board -p NOVA

# Check statuses
tm check-statuses -p NOVA

# Health check
tm health-check

Troubleshooting

Board Not Created

bash
# Check if board exists
tm project-info -p NOVA

# Recreate board
tm setup-board -p NOVA -n "Cursor Automation"

Webhook Not Working

  1. Check webhook URL is accessible
  2. Verify ATLASSIAN_TM_WEBHOOK_SECRET matches Jira
  3. Check api-report.md for errors
  4. Test webhook manually in Jira

Workflow Not Triggering

  1. Check assignee: Must be exactly cursor.automation
  2. Check Orchestrator: ORCHESTRATOR_ENABLED=true
  3. Check logs: Review api-report.md
  4. Test manually: tm test-workflow -p NOVA

API Report Issues

bash
# View report
cat .orchestrator/api-report.md

# Check for failures
grep "❌" .orchestrator/api-report.md

# Check recent activity
tail -50 .orchestrator/api-report.md

Next Steps

  1. ✅ Setup board: tm setup-board -p NOVA
  2. ✅ Test workflow: tm test-workflow -p NOVA
  3. ✅ Create tickets: tm create -p NOVA -t "Task" -u cursor.automation
  4. ✅ Monitor: Check api-report.md regularly

Related Documentation