Creating Tasks

# Basic task creation
forge task create \
  --title "Add user authentication" \
  --description "Implement JWT-based auth with login and signup" \
  --llm claude

# With additional options
forge task create \
  --title "Refactor API client" \
  --description "Convert fetch calls to axios" \
  --llm gemini \
  --priority high \
  --labels "refactor,backend" \
  --assignee "claude"

You: "Create a task to add dark mode toggle with LocalStorage persistence"

Claude Code: I'll create that task for you...

[Uses MCP create_task tool]

Task created: #42 "Add dark mode toggle"

forge task create \
  --title "Add export to CSV functionality" \
  --type feature \
  --description "
  Create CSV export feature:
  - Add download button to UI
  - Implement CSV generation logic
  - Handle large datasets (stream)
  - Add progress indicator
  - Include proper filename with timestamp
  " \
  --labels "feature,ui,backend"

forge task create \
  --title "Fix memory leak in WebSocket connection" \
  --type bugfix \
  --priority high \
  --description "
  Steps to reproduce:
  1. Connect to WebSocket
  2. Leave page open for 1 hour
  3. Memory usage grows continuously

  Expected: Stable memory usage
  Actual: Memory grows by ~50MB/hour

  Stack trace: [attach if available]
  " \
  --labels "bug,websocket,critical"

forge task create \
  --title "Extract API client to separate module" \
  --type refactor \
  --description "
  Current state: API calls scattered across components
  Goal: Centralized API client with:
  - Axios instance with interceptors
  - Error handling middleware
  - Retry logic for failed requests
  - TypeScript types for all endpoints
  " \
  --labels "refactor,architecture"

forge task create \
  --title "Document authentication flow" \
  --type docs \
  --description "
  Create comprehensive docs for:
  - How JWT tokens are generated
  - Token refresh flow
  - Password reset process
  - OAuth integration
  Include sequence diagrams
  " \
  --labels "docs,auth"

forge task create \
  --title "Add integration tests for payment flow" \
  --type testing \
  --description "
  Test scenarios:
  - Successful payment
  - Failed payment (card declined)
  - Network timeout during payment
  - Webhook handling
  - Refund flow

  Use Jest + Supertest
  Aim for 90%+ coverage
  " \
  --labels "testing,payment"

Add user stuff to the dashboard

## Goal
Add user management section to admin dashboard

## Requirements
- Display paginated user list (20 per page)
- Show: name, email, registration date, status
- Add filters: status (active/inactive), role
- Implement search by name or email
- Add "Edit User" modal with:
  - Change role (user/admin)
  - Toggle active status
  - Reset password option

## Technical Notes
- Use existing UserService API
- Match design system components
- Add loading states and error handling
- Include unit tests for filtering logic

## Acceptance Criteria
- [ ] User list loads and paginates correctly
- [ ] Filters work as expected
- [ ] Search returns accurate results
- [ ] Edit modal saves changes successfully
- [ ] All edge cases handled (empty state, API errors)

# Category labels
--labels "feature,bug,docs,refactor,testing"

# Priority labels
--labels "priority:high,priority:low"

# Component labels
--labels "frontend,backend,database,auth"

# Status labels
--labels "blocked,in-review,needs-testing"

# Team labels
--labels "team:mobile,team:api"

# Combine multiple
--labels "feature,backend,priority:high,team:api"

# By label
forge task list --labels "feature"
forge task list --labels "priority:high"

# By status
forge task list --status pending
forge task list --status in_progress

# By assignee
forge task list --assignee claude

# Combine filters
forge task list --labels "bug" --priority high --status pending

forge task create \
  --title "Optimize database query" \
  --description "
  Current slow query:
  \`\`\`sql
  SELECT * FROM users
  WHERE created_at > NOW() - INTERVAL 30 DAY
  \`\`\`

  Takes 5 seconds on 1M users. Add index on created_at.
  "

## References
- Design: https://figma.com/file/xyz
- API Docs: https://docs.example.com/api
- Similar feature: https://github.com/user/repo/pull/123

# Create parent task
forge task create \
  --title "Build payment system" \
  --id parent-task

# Create dependent tasks
forge task create \
  --title "Stripe integration" \
  --depends-on parent-task

forge task create \
  --title "Payment UI components" \
  --depends-on parent-task

forge task create \
  --title "Webhook handling" \
  --depends-on parent-task

tasks:
  - title: "Setup database schema"
    description: "Create tables for users, posts, comments"
    priority: high
    labels: ["database", "setup"]

  - title: "Create API endpoints"
    description: "CRUD operations for posts"
    labels: ["backend", "api"]

  - title: "Build frontend components"
    description: "Post list, create post form"
    labels: ["frontend", "ui"]

forge task import tasks.yaml

import { ForgeClient } from 'automagik-forge-sdk';

const forge = new ForgeClient();

const tasks = [
  { title: "Task 1", description: "..." },
  { title: "Task 2", description: "..." },
  { title: "Task 3", description: "..." },
];

for (const task of tasks) {
  await forge.createTask(task);
}