К основному содержанию
плагин CX Codex

task-scheduler — плагин для Claude Code: что делает и как установить

Плагин task-scheduler раскладывает JSON-список задач по дням с учётом дедлайнов, доступных часов, заблокированных дат и перегруза. Отдаёт markdown-план.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install task-scheduler@awesome-codex-plugins
Открыть на GitHub

Что делает task-scheduler

На вход идёт JSON: либо массив задач, либо объект с массивом tasks и параметрами окна. У задачи есть название, дедлайн в формате YYYY-MM-DD, оценка в часах, приоритет от 1 до 5, заметки и теги. В метаданных — дата старта, число дней, часы в день, заблокированные даты и переопределения ёмкости на конкретный день. На выходе markdown с разделами Summary, Schedule, Follow-Ups и Risks.

Черновик собирается из терминала: python ./scripts/build_schedule.py --input ./scripts/example_tasks.json. Флаги --start-date, --days, --hours-per-day и --output перекрывают то, что записано в файле. Для агентских сценариев поднят локальный stdio MCP-сервер с инструментами build_task_schedule, analyze_schedule_capacity и build_task_schedule_from_file, а скилл skills/task-planner/SKILL.md помогает вытянуть ограничения из разговора и назвать риски.

Сервер стартует командой python ./scripts/mcp_server.py, прописанной в .mcp.json, поэтому без Python и пакетов из scripts/requirements-mcp.txt инструменты не поднимутся — зависимости ставятся до первого запуска.

Какие задачи решает

  • разложить список задач по дням с учётом дедлайнов
  • заблокировать выходной и пересчитать план на остаток недели
  • посчитать, сколько часов не хватает до сдачи
  • отдать расписание другому агенту через MCP-вызов
  • получить черновик плана в markdown для правки руками

Примеры запросов агенту

  • Собери расписание по scripts/example_tasks.json на 6 дней
  • Проанализируй ёмкость: хватит ли часов до дедлайнов?
  • Построй план на неделю, субботу заблокируй и поставь 4 часа на понедельник

Как установить task-scheduler

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install task-scheduler@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о task-scheduler

Как установить task-scheduler в Claude Code?

Через маркетплейс: сначала /plugin marketplace add hashgraph-online/awesome-codex-plugins, потом /plugin install task-scheduler@awesome-codex-plugins.

Что делает task-scheduler?

Превращает задачи с дедлайнами и оценками в посуточный план на markdown и отдельно показывает, что не влезло в окно планирования.

Что нужно, чтобы заработал MCP-сервер?

Python и пакеты из scripts/requirements-mcp.txt, установленные командой python -m pip install -r ./scripts/requirements-mcp.txt. Запуск идёт через python ./scripts/mcp_server.py.

Исходный текст

task-scheduler-codex-plugin · MIT
# Task Scheduler for OpenAI Codex

Task Scheduler is an OpenAI Codex plugin that turns raw task lists into realistic schedules.

It combines three pieces in one plugin package:

- a Codex plugin manifest and marketplace-ready metadata
- a reusable MCP server that other agents and tools can call
- a local CLI for generating schedule drafts from structured JSON input

The plugin is designed for practical planning. It balances deadlines, available hours, blocked dates, and per-day capacity changes, then returns a markdown plan with follow-ups and risks.

![Task Scheduler logo](./assets/logo.png)

## Highlights

- Converts task JSON into a day-by-day schedule
- Supports blocked dates and daily capacity overrides
- Tracks overflow when tasks do not fit inside the planning window
- Exposes MCP tools so other agents can call the scheduler directly
- Includes a Codex skill for planning-oriented prompts
- Ships with example assets, sample data, and starter plugin metadata

## Who This Is For

- Codex users who want a local productivity plugin
- plugin authors learning how to combine plugin manifests, skills, and MCP
- teams that want a lightweight planning tool agents can call from the same workspace

## Repository Layout

```text
task-scheduler/
|-- .codex-plugin/
|   `-- plugin.json
|-- assets/
|   |-- icon.png
|   |-- logo.png
|   `-- screenshot*.png
|-- hooks/
|   `-- README.md
|-- scripts/
|   |-- build_schedule.py
|   |-- example_tasks.json
|   |-- mcp_server.py
|   |-- requirements-mcp.txt
|   `-- task_scheduler_core.py
|-- skills/
|   `-- task-planner/
|       `-- SKILL.md
|-- .app.json
|-- .mcp.json
|-- hooks.json
`-- README.md
```

## Features

### 1. Local CLI scheduling

Use the CLI when you want a quick schedule from a JSON file:

```powershell
python .\scripts\build_schedule.py `
  --input .\scripts\example_tasks.json
```

Optional flags:

- `--start-date YYYY-MM-DD`
- `--days <int>`
- `--hours-per-day <number>`
- `--output <path>`

These flags override the values inside the JSON input file when present.

### 2. MCP tools for agent workflows

The plugin exposes a local stdio MCP server so other agents and tools can call the scheduler without shelling out directly.

Implemented MCP tools:

- `build_task_schedule`
- `analyze_schedule_capacity`
- `build_task_schedule_from_file`

Implemented MCP resources:

- `task-scheduler://sample-input`
- `task-scheduler://readme`

Implemented MCP prompt:

- `schedule_prompt`

### 3. Codex skill support

The included skill at `skills/task-planner/SKILL.md` helps Codex gather constraints, create a realistic plan, and call out risk and overflow clearly.

## Input Format

The scheduler accepts either:

- a plain JSON array of tasks
- a JSON object containing `tasks` plus planning metadata

### Minimal input

```json
[
  {
    "title": "Finalize project brief",
    "due": "2026-04-03",
    "estimated_hours": 2.5,
    "priority": 5,
    "notes": "Needs stakeholder review"
  }
]
```

### Full input

```json
{
  "start_date": "2026-04-01",
  "days": 6,
  "hours_per_day": 6,
  "blocked_dates": ["2026-04-04"],
  "daily_capacity_overrides": {
    "2026-04-03": 3.5,
    "2026-04-06": 4
  },
  "notes": "Protect Saturday for admin catch-up.",
  "tasks": [
    {
      "title": "Finalize project brief",
      "due": "2026-04-02",
      "estimated_hours": 2,
      "priority": 5,
      "tags": ["strategy", "stakeholders"],
      "notes": "Share with stakeholders before noon."
    }
  ]
}
```

### Supported task fields

- `title`: task name
- `due`: due date in `YYYY-MM-DD`
- `estimated_hours`: expected work in hours
- `priority`: integer from 1 to 5
- `notes`: optional detail shown in output
- `tags`: optional string array for categorization

### Supported schedule metadata

- `start_date`: planning window start
- `days`: number of days in the window
- `hours_per_day`: default daily capacity
- `blocked_dates`: dates with zero scheduling capacity
- `daily_capacity_overrides`: per-day hour overrides
- `notes`: planning context echoed into the output

## Example Output

The generated markdown includes:

- `Summary`
- `Schedule`
- `Follow-Ups`
- `Risks`

This makes it readable for humans and easy for agents to refine.

## Installation

### 1. Clone or copy the repository

This repository is structured with the plugin at the repo root.

```text
task-scheduler-codex-plugin/
```

To use it as a Codex plugin inside another workspace, place this repository or a copy of it under:

```text
plugins/task-scheduler
```

### 2. Install the MCP dependency

```powershell
python -m pip install -r .\scripts\requirements-mcp.txt
```

### 3. Verify the plugin manifest

The manifest lives at:

```text
.codex-plugin/plugin.json
```

This plugin already references:

- `./skills/`
- `./hooks.json`
- `./.mcp.json`
- `./.app.json`

### 4. Verify the MCP config

The MCP config lives at:

```text
.mcp.json
```

It starts the local server with:

```json
{
  "mcpServers": {
    "taskScheduler": {
      "command": "python",
      "args": ["./scripts/mcp_server.py"],
      "cwd": "."
    }
  }
}
```

### 5. Optional marketplace registration

If you want the plugin to appear in Codex UI ordering, register it in your marketplace file:

```text
.agents/plugins/marketplace.json
```

This repo already includes a starter marketplace entry.

## Quick Start

### Run the CLI

```powershell
python .\scripts\build_schedule.py `
  --input .\scripts\example_tasks.json
```

### Start the MCP server directly

```powershell
python .\scripts\mcp_server.py
```

### Use the example data

Sample input lives at:

```text
scripts/example_tasks.json
```

## Documentation

- [Getting Started](./docs/GETTING_STARTED.md)
- [MCP Reference](./docs/MCP_REFERENCE.md)
- [Architecture](./docs/ARCHITECTURE.md)
- [Development Guide](./docs/DEVELOPMENT.md)
- [Publishing Guide](./docs/PUBLISHING.md)
- [Contributing](./CONTRIBUTING.md)
- [Security Policy](./SECURITY.md)
- [Privacy Policy](./PRIVACY.md)
- [Terms of Service](./TERMS.md)

## Current Status

This plugin is a strong local starter and learning reference. It is already useful for local scheduling and MCP-based planning flows, but a few areas are still intentionally starter-level:

- `.app.json` integration details
- runtime hook registrations in `hooks.json`
- final production screenshots and branding assets

## Roadmap Ideas

- add more MCP tools such as automatic overflow rescheduling
- support recurring tasks and dependency chains
- add export formats beyond markdown
- connect planner output to external task systems
- add repository releases and changelog automation

## License

MIT, unless you choose a different license for your public repository.

© zeyad elsharkawy · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Заметки, задачи и проекты» →
task-management официальный anthropics Скилл task-management ведёт список задач в локальном файле TASKS.md и показывает интерактивный дашборд. Пригодится, чтобы фиксировать дедлайны и поручения прямо во время диалога с агентом. CX Codex +1 7 500установок screenshot-synthesizer davila7 Субагент screenshot-synthesizer объединяет JSON-отчёты по интерфейсу, взаимодействию и бизнес-логике в единый список задач разработки в формате Markdown. CX Codex 346установок planning-and-task-breakdown addyosmani Скилл planning-and-task-breakdown разбивает спецификацию на небольшие проверяемые задачи с явными критериями приемки. Помогает агенту спланировать архитектуру до написания кода и избежать путаницы. CX Codex +1 80 700установок plan OthmanAdi Команда запускает файловое планирование в стиле Manus для сложных задач. Она создаёт файлы task_plan.md, findings.md и progress.md либо подхватывает уже начатый план проекта. CX Codex +1 ★ 28 179звёзд репо planner jdrhyne Скилл planner разбивает сложные задачи на спринты и атомарные шаги с проверками, готовя детальный Markdown-план для параллельного выполнения субагентами. CX Codex +1 ★ 239звёзд репо design-task crewAIInc Скилл design-task помогает составлять и отлаживать задачи для CrewAI. Он задаёт правила для описаний, ожидаемых результатов, зависимостей и вывода в Pydantic. CX Codex +1 8 900установок

Из того же набора391

Весь набор →
tokrepo-search Плагин tokrepo-search помогает искать в TokRepo и устанавливать скиллы, промпты, MCP-конфигурации и воркфлоу. Внутри — скилл и MCP-сервер. CX Codex ★ 1 596звёзд репо tokenchronicle Плагин tokenchronicle сохраняет историю работы в локальный архив, чтобы искать прошлые сессии, считать потраченные токены и восстанавливать контекст без переоплаты. CX Codex ★ 1 596звёзд репо thermal-fluid-research-workflow Плагин thermal-fluid-research-workflow для Claude Code и Codex проверяет расчёты CFD и неопределённости, а также помогает готовить научные статьи по теплофизике и гидродинамике. CX Codex ★ 1 596звёзд репо teaching-skills Плагин teaching-skills для Claude Code помогает проектировать курсы, готовить занятия и оценивать работы. Маршрутизатор выбирает один из 15 рабочих процессов по запросу. CX Codex ★ 1 596звёзд репо talivia-agent-kit Плагин talivia-agent-kit подключает аналитику Talivia к проекту через Claude Code: агент настраивает трекер под фреймворк, проверяет входящие события и связывает платежи с источниками трафика. CX Codex ★ 1 596звёзд репо taisly-agent-kit Плагин taisly-agent-kit подключает инструкции по публикации видео и инструменты Taisly для соцсетей. Агент может проверить аккаунты, подготовить пост и запросить подтверждение перед публикацией. CX Codex ★ 1 596звёзд репо tablejourney Плагин подключает к Claude Code фуд-гид TableJourney: проверенные места поесть, фестивали еды и готовые маршруты в 200+ городах. CX Codex ★ 1 596звёзд репо sysknife Плагин sysknife превращает запросы на обычном языке в типизированные команды для Linux с уровнями риска. Действия запускает фоновый демон только после подтверждения в терминале. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой