# Find Code Tasks

Lists all code tasks in the repository with their status, dates, and metadata.

- Repository: https://github.com/mikeyobrien/ralph-orchestrator (3190 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add mikeyobrien/ralph-orchestrator --skill find-code-tasks -g -a claude-code -y`
Codex: `npx skills add mikeyobrien/ralph-orchestrator --skill find-code-tasks -g -a codex -y`
Cursor: `npx skills add mikeyobrien/ralph-orchestrator --skill find-code-tasks -g -a cursor -y`
Gemini CLI: `npx skills add mikeyobrien/ralph-orchestrator --skill find-code-tasks -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add mikeyobrien/ralph-orchestrator`

## Description

Lists all code tasks in the repository with their status, dates, and metadata. Useful for getting an overview of pending work or finding specific tasks.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Find Code Tasks

## Overview

This skill finds and displays all code tasks (`.code-task.md` files) in the repository, showing their frontmatter status and metadata. Use it to get a quick overview of pending work, find tasks by status, or check the state of the task backlog.

## When to Use

- Starting a work session to see what tasks are available
- Checking status of tasks before/after running code-assist
- Finding tasks by status (pending, in_progress, completed)
- Getting a summary of task backlog
- Exporting task data for reporting

## Parameters

- **filter** (optional): Filter tasks by status
  - `pending` - Show only pending tasks
  - `in_progress` - Show only in-progress tasks
  - `completed` - Show only completed tasks
  - (none) - Show all tasks

- **format** (optional, default: "table"): Output format
  - `table` - Human-readable table with status symbols
  - `json` - JSON array for programmatic use
  - `summary` - Counts by status only

- **tasks_dir** (optional, default: ".ralph/tasks/"): Directory to search for tasks

## Usage Examples

```bash
# Show all tasks in table format
/find-code-tasks

# Show only pending tasks
/find-code-tasks filter:pending

# Get JSON output for tooling
/find-code-tasks format:json

# Quick summary of task counts
/find-code-tasks format:summary

# Search custom directory
/find-code-tasks tasks_dir:tools/
```

## Steps

### 1. Run Task Status Script

The script is colocated with this skill at `.claude/skills/find-code-tasks/task-status.sh`.

Execute it with appropriate arguments:

```bash
# Default: table format, all tasks
.claude/skills/find-code-tasks/task-status.sh

# With filter
.claude/skills/find-code-tasks/task-status.sh --pending
.claude/skills/find-code-tasks/task-status.sh --in_progress
.claude/skills/find-code-tasks/task-status.sh --completed

# With format
.claude/skills/find-code-tasks/task-status.sh --json
.claude/skills/find-code-tasks/task-status.sh --summary

The rest: https://github.com/mikeyobrien/ralph-orchestrator/blob/HEAD/.claude/skills/find-code-tasks/SKILL.md