> ## Documentation Index
> Fetch the complete documentation index at: https://docs.median.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# mdn tasks

> List and filter tasks.

## Usage

```bash theme={null}
mdn tasks [flags]
```

`mdn tasks` uses the workspace selected by the nearest `.median/config.json`. If no project-local config exists, it uses your global default profile.

## Flags

| Flag                    | Short | Description                |
| ----------------------- | ----- | -------------------------- |
| `--status <status>`     | `-s`  | Filter by status           |
| `--priority <priority>` | `-p`  | Filter by priority         |
| `--label <label>`       | `-l`  | Filter by label            |
| `--agent <name>`        |       | Identify the calling agent |
| `--json`                |       | Output raw JSON            |

## Examples

```bash theme={null}
# List all tasks
mdn tasks

# Filter by status
mdn tasks --status todo

# Filter by priority
mdn tasks --priority urgent

# Combine filters
mdn tasks --status in_progress --priority high

# Agent-identified
mdn tasks --agent claude-code

# JSON output for scripting
mdn tasks --json | jq '.[] | .taskCode'
```

## Output

```
  Median Workspace Tasks

  Code         Title                          Status          Priority    Agent
  ──────────────────────────────────────────────────────────────────────────────
  MED-42       Fix authentication bug         In Progress     !! Urgent   claude-code
  MED-43       Add dark mode support          Todo            ↑ High
  MED-44       Update API documentation       Ready           ─ Medium

  3 tasks
```

### Statuses

`requests` | `todo` | `in_progress` | `ready` | `shipped` | `archive`

### Priorities

`urgent` (`!!`) | `high` (`↑`) | `medium` (`─`) | `low` (`↓`) | `none`