Planifica el uso de la cuota semanal de OpenAI Codex mediante la previsión de resets adicionales y la gestión de resets acumulados a través de diversas estrategias de uso.
También conocido como ItsOdeLeo/codex4ever
- Stars
- 5
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.1.3
- Último commit
- 29 oct 2026
- Licencia
- MIT
¿Qué es Usage Planner MCP?
Usage Planner es un MCP server. Planifica el uso de la cuota semanal de OpenAI Codex mediante la previsión de resets adicionales y la gestión de resets acumulados a través de diversas estrategias de uso.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Usage Planner
Codex4ever, ahora conocido como Usage Planner, ayuda a los desarrolladores a gestionar sus cuotas semanales de OpenAI Codex. Proporciona una línea de tiempo de dos semanas que rastrea el uso diario, la cuota restante y los posibles puntos de agotamiento. La herramienta está diseñada para usuarios que quieren predecir cuándo expirará su cuota y decidir cuándo canjear los resets acumulados. Ofrece cinco estrategias distintas, incluyendo Keep pace, Keep available, Use it all, Weekdays only y Weekend focus.
Los usuarios pueden acceder al planificador a través de un sitio web en el navegador, un plugin de Codex o como un MCP server para clientes como Claude Desktop y Cursor. Al usar el MCP server o el plugin, el sistema lee los datos de cuota locales de la sesión iniciada desde un Codex CLI en la misma máquina, por lo que no requiere API keys adicionales. El motor de previsión utiliza el historial público de resets para predecir resets adicionales con al menos un 60% de probabilidad, ubicándolos en horarios conservadores para garantizar la fiabilidad.
Qué puedes hacer con él
- 1Prever el agotamiento de la cuotaDetermina exactamente cuándo tu ritmo de uso actual hará que te quedes sin cuota de Codex.
- 2Predecir resets adicionalesEstima la probabilidad y el momento en que ocurrirá un reset automático dentro de las próximas 48 horas.
- 3Aplicar estrategias de usoAjusta tu planificación según necesidades específicas, como usar el servicio únicamente los días laborables.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Usage Planner MCP
Formatos verificados el 10 nov 2026Instalar Usage Planner MCP en Claude Code
$ claude mcp add codex4ever -- npx -y codex4everInstalar Usage Planner MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"codex4ever": {
"command": "npx",
"args": [
"-y",
"codex4ever"
]
}
}
}Instalar Usage Planner MCP en VS Code
.vscode/mcp.json
{
"servers": {
"codex4ever": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"codex4ever"
]
}
}
}Instalar Usage Planner MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"codex4ever": {
"command": "npx",
"args": [
"-y",
"codex4ever"
]
}
}
}Instalar Usage Planner MCP en Codex
~/.codex/config.toml
[mcp_servers.codex4ever] command = "npx" args = ["-y", "codex4ever"]
Instalar Usage Planner MCP en Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"codex4ever": {
"command": "npx",
"args": [
"-y",
"codex4ever"
]
}
}
}Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleitsodeleo/codex4ever is public and reachablegithub.com/itsodeleo/codex4ever ↗Aprobado
- El paquete cita este repositorio como fuentecodex4ever names itsodeleo/codex4ever as sourcenpmjs.com/package/codex4ever ↗Aprobado
- Procedencia de la compilación (atestación Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-29github.com/itsodeleo/codex4ever ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from codex4everAprobado
- Sin avisos críticos en el paquete ni en sus dependencias1 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake MCPNo verificado
README
Ver en GitHubUsage Planner — Codex quota & reset planner
Usage Planner (formerly Codex4ever) is a planner for your OpenAI Codex weekly quota. It shows when your quota runs out at your current pace, whether a predicted extra reset is likely to arrive first, and when a banked reset is worth redeeming.
Unofficial; not affiliated with OpenAI. MIT licensed.
Pick a strategy
Ask once in Codex and the planner opens beside the chat. Pick a strategy and the plan changes: daily usage, refills and run-out points.
What it does
- Timeline of your next two weeks — daily usage, remaining quota, run-out points, outages, normal refreshes and banked-reset uses, one column per day.
- Extra-reset forecast — the chance of an automatic reset in the next 48 hours, the likely window, and a second reset conditioned on the first, built from public reset history and Tibo's public posts.
- Five strategies — Keep pace (your current pace: see when quota runs out), Keep available, Use it all (empty quota just before the next refill), Weekdays only, Weekend focus.
- Codex plugin — reads your local, signed-in quota and banked resets, plans in the conversation, and opens the same visual planner.
How it plans
- A predicted reset is counted only when it is at least 60% likely before the refresh in effect, and it is placed at a conservative time (where it has most probably already happened), not at its single most likely hour. You can switch the count to 0, 1 or 2 on the timeline.
- Every refill restarts the seven-day window — a banked reset, an extra reset or the normal refresh.
- Banked resets: extras cover outages, earliest expiry first; the last one is kept for a real outage (24 h or more), and a bank about to expire can be used rather than wasted.
- One rule everywhere: the website, the plugin page and the plugin's MCP tools always give the same plan for the same inputs.
The forecast is an uncalibrated model estimate, not a promise. Usage Planner never redeems a reset or spends credits for you.
Use it
Codex plugin (Node.js 20+ and a signed-in Codex app or CLI):
codex plugin marketplace add ItsOdeLeo/usage-planner
codex plugin add usage-planner@usage-planner
Start a new Codex chat and ask: "Open quota planning." Reading your quota is local and read-only; no separate API key is needed.
Other MCP clients (Claude Code, Claude Desktop, Cursor and others): the same server is on npm as usage-planner and in the MCP Registry as io.github.ItsOdeLeo/usage-planner. Reading your quota still needs a signed-in Codex CLI on the same machine.
{ "mcpServers": { "usage-planner": { "command": "npx", "args": ["-y", "usage-planner"] } } }
Website: usageplanner.com, no install. Enter your quota by hand; everything is calculated in your browser and your inputs are not sent anywhere.
Run locally:
npm install
npm run web # http://127.0.0.1:4173/
npm test
Data sources
Public reset data comes from Codex Resets, including the bundled offline archive (npm run archive:refresh). Thanks to its maintainer. With an optional X API token, Tibo's full timeline is read directly from X.
Development
| Command | What it does |
|---|---|
npm run web |
Local site with live reset evidence (cached 30 minutes) |
npm run site:build |
Static site in dist/, evidence collected at build time |
npm run plugin:build |
Self-contained Codex plugin in plugins/usage-planner/ |
npm run mcp |
MCP server from source |
npm run backtest:public |
Day-by-day replay of the forecast against public history |
.github/workflows/deploy-site.yml rebuilds the static site every 30 minutes and deploys it to Cloudflare Pages. Optional settings (LLM classification of posts, X timeline access) are listed in .env.example; keys are only read at build time and never reach the browser.
Design and algorithm details: docs/technical-notes.zh.md (Chinese).
中文简介
Usage Planner（原名 Codex4ever）是 OpenAI Codex 每周额度的本地规划器：按你当前的速度显示额度什么时候用完、额外 reset 是否可能先到，以及备用 reset 什么时候值得用。预测的 reset 只在“正常刷新前发生的概率 ≥ 60%”时计入，并放在保守时刻；任何一次补满都会重新开始 7 天周期；备用默认至少保留一个。网页、插件页面和插件的 MCP 工具始终使用同一套规则。非官方工具，与 OpenAI 无隶属关系。详细设计见 技术说明。
Author
Built by 欧的Leo — @ItsOdeLeo on X · 小红书 ItsOdeLeo. Feedback and ideas are welcome there or in GitHub issues.
Preguntas sobre Usage Planner MCP
¿Cómo agrego Usage Planner MCP a Claude Code?
Ejecuta claude mcp add codex4ever -- npx -y codex4ever en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Usage Planner MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Cómo funciona la previsión de resets adicionales?
Calcula la probabilidad de un reset automático en las próximas 48 horas basándose en el historial público de resets y publicaciones en redes sociales, contabilizándolo solo si tiene al menos un 60% de probabilidad.
¿Qué estrategias de uso están disponibles?
El planificador ofrece cinco estrategias: Keep pace, Keep available, Use it all, Weekdays only y Weekend focus.