fulcrum

# Fulcrum - AI Orchestration Platform

## Overview

Fulcrum is an AI orchestration and task management platform. It provides task tracking, project management, and tools for AI agents to work autonomously across isolated git worktrees.

**Key Features:**
- Task management with kanban boards and status tracking
- Project and repository organization
- Git worktree isolation for parallel development
- Docker Compose app deployment
- Multi-channel notifications
- MCP tools for AI agent integration

## When to Use This Skill

Use the Fulcrum CLI when:
- **Working in a task worktree** - Use `current-task` commands to manage your current task
- **Updating task status** - Mark tasks as in-progress, ready for review, done, or canceled
- **Linking PRs** - Associate a GitHub PR with the current task
- **Linking URLs** - Attach any relevant URLs (design docs, specs, external resources) to the task
- **Sending notifications** - Alert the user when work is complete or needs attention
- **Server management** - Start, stop, and check server status

Use the Fulcrum MCP tools when:
- **Task CRUD operations** - Create, list, update, delete tasks
- **Project/repository management** - Create, organize, and manage projects and repositories
- **App deployment** - Deploy, stop, and monitor Docker Compose applications
- **Filesystem operations** - Read, write, and edit files on the Fulcrum server
- **Executing commands remotely** - Run shell commands on the Fulcrum server from Claude Desktop
- **Stateful workflows** - Use persistent sessions to maintain environment variables and working directory across commands

## Core CLI Commands

### current-task (Primary Agent Workflow)

When running inside a Fulcrum task worktree, use these commands to manage the current task:

```bash
# Get current task info (comprehensive output with dependencies, attachments, etc.)
fulcrum current-task

# Update task status
fulcrum current-task in-progress   # Mark as IN_PROGRESS
fulcrum current-task review