# usage-planner

MCP-сервер usage-planner для Claude Code рассчитывает расход недельной квоты OpenAI Codex и прогнозирует сбросы лимитов. Сервер строит двухнедельный график использования.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 у репозитория
- Автор: ItsOdeLeo
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ItsOdeLeo/usage-planner
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/usage-planner

## Что делает

MCP-сервер считывает данные авторизованной сессии Codex CLI, оценивает остаток недельной квоты и строит таймлайн расхода на две недели вперёд. Расчёт учитывает вероятность внепланового сброса лимита в ближайшие 48 часов, плановые еженедельные обновления и запасные сбросы (banked resets).

Модель прогноза включает дополнительный сброс в график только при вероятности от 60% и выбирает осторожное время наступления. Доступно пять стратегий распределения лимитов, включая работу только по будням или удержание запаса на случай сбоев.

Для чтения баланса на компьютере требуется Node.js 20+ и авторизованный клиент Codex CLI. Сам сервер баланс не тратит и сбросы не активирует.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add usage-planner -- npx -y usage-planner
```

### Codex

**Командой платформы**
```bash
codex mcp add usage-planner -- npx -y usage-planner
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "usage-planner": {
            "command": "npx",
            "args": [
                "-y",
                "usage-planner"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "usage-planner": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "usage-planner"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add usage-planner npx -y usage-planner
```

## Когда брать
- рассчитать дату исчерпания недельного лимита токенов Codex
- спрогнозировать вероятность внеочередного сброса квоты в ближайшие двое суток
- выбрать момент применения отложенного сброса лимита
- распределить квоту по пяти стратегиям расхода на две недели

## Примеры запросов агенту
- Покажи прогноз расхода квоты Codex на ближайшие дни
- Оцени, когда закончится недельный лимит при текущем темпе запросов
- Построй график распределения квоты по стратегии для рабочих дней

## Похожие
- [event-planner](https://affpapa.org/nevibecode/skills/event-planner.md) — скилл · 253 установки
- [sales-quota-setting](https://affpapa.org/nevibecode/skills/sales-quota-setting.md) — скилл · 33600 установок
- [recipe-find-large-files](https://affpapa.org/nevibecode/skills/recipe-find-large-files.md) — скилл · 31300 установок
- [codex-quota-title](https://affpapa.org/nevibecode/plugins/codex-quota-title.md) — плагин · ★ 1596 у репозитория
- [foundation-meeting-synthesize](https://affpapa.org/nevibecode/skills/foundation-meeting-synthesize.md) — скилл · 778 установок
- [claude-usage-analyst](https://affpapa.org/nevibecode/skills/claude-usage-analyst.md) — скилл · 471 установка

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
