Plant die wöchentliche Nutzung deines OpenAI Codex Quotas, indem zusätzliche Resets prognostiziert und angesammelte Resets durch verschiedene Nutzungsstrategien verwaltet werden.
Auch bekannt als ItsOdeLeo/codex4ever
- Stars
- 5
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 0.1.3
- Letzter Commit
- 29. Okt. 2026
- Lizenz
- MIT
Was ist Usage Planner MCP?
Usage Planner ist ein MCP server. Plant die wöchentliche Nutzung deines OpenAI Codex Quotas, indem zusätzliche Resets prognostiziert und angesammelte Resets durch verschiedene Nutzungsstrategien verwaltet werden.
Zusammenfassung generiert aus dem README des Projekts
Über Usage Planner MCP server
Codex4ever, jetzt bekannt als Usage Planner, hilft Entwicklern dabei, ihre wöchentlichen OpenAI Codex Quotas zu verwalten. Es bietet eine Zwei-Wochen-Timeline, die den täglichen Verbrauch, das verbleibende Quota und potenzielle Zeitpunkte des Erschöpfens trackt. Das Tool ist für Nutzer gedacht, die vorhersagen wollen, wann ihr Quota abläuft, und entscheiden müssen, wann sie angesammelte Resets einlösen. Es bietet fünf verschiedene Strategien, darunter Keep pace, Keep available, Use it all, Weekdays only und Weekend focus.
Nutzer können auf den Planner über eine browserbasierte Website, ein Codex Plugin oder als MCP server für Clients wie Claude Desktop und Cursor zugreifen. Wenn du den MCP server oder das Plugin nutzt, liest das System lokale, angemeldete Quota-Daten von einem Codex CLI auf derselben Maschine aus, sodass keine zusätzlichen API Keys benötigt werden. Die Forecasting-Engine nutzt öffentliche Reset-Historien, um zusätzliche Resets mit einer Wahrscheinlichkeit von mindestens 60 % vorherzusagen, wobei diese konservativ eingeplant werden, um Zuverlässigkeit zu gewährleisten.
Was du damit machen kannst
- 1Quota-Erschöpfung prognostizierenErmittle genau, wann deine aktuelle Nutzungsrate dazu führen wird, dass dein Codex Quota aufgebraucht ist.
- 2Zusätzliche Resets vorhersagenSchätze die Wahrscheinlichkeit und den Zeitpunkt eines automatischen Resets innerhalb der nächsten 48 Stunden ab.
- 3Nutzungsstrategien anwendenPasse deine Planung an spezifische Bedürfnisse an, wie zum Beispiel die Nutzung des Services nur an Wochentagen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Usage Planner MCP
Formate geprüft am 10. Nov. 2026Usage Planner MCP in Claude Code installieren
$ claude mcp add codex4ever -- npx -y codex4everUsage Planner MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"codex4ever": {
"command": "npx",
"args": [
"-y",
"codex4ever"
]
}
}
}Usage Planner MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"codex4ever": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"codex4ever"
]
}
}
}Usage Planner MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"codex4ever": {
"command": "npx",
"args": [
"-y",
"codex4ever"
]
}
}
}Usage Planner MCP in Codex installieren
~/.codex/config.toml
[mcp_servers.codex4ever] command = "npx" args = ["-y", "codex4ever"]
Usage Planner MCP in Gemini CLI installieren
~/.gemini/settings.json
{
"mcpServers": {
"codex4ever": {
"command": "npx",
"args": [
"-y",
"codex4ever"
]
}
}
}Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbaritsodeleo/codex4ever is public and reachablegithub.com/itsodeleo/codex4ever ↗Bestanden
- Paket nennt dieses Repository als Quellecodex4ever names itsodeleo/codex4ever as sourcenpmjs.com/package/codex4ever ↗Bestanden
- Build-Herkunft (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-29github.com/itsodeleo/codex4ever ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from codex4everBestanden
- Kein kritischer Hinweis im Paket oder seinen Abhängigkeiten1 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenUsage 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.
Usage Planner MCP Fragen
Wie füge ich Usage Planner MCP zu Claude Code hinzu?
Führe claude mcp add codex4ever -- npx -y codex4ever in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Usage Planner MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Wie funktioniert die Prognose für zusätzliche Resets?
Sie berechnet die Wahrscheinlichkeit eines automatischen Resets in den nächsten 48 Stunden basierend auf öffentlicher Reset-Historie und Social-Media-Posts. Ein Reset wird nur gezählt, wenn die Wahrscheinlichkeit bei mindestens 60 % liegt.
Welche Nutzungsstrategien stehen zur Verfügung?
Der Planner bietet fünf Strategien: Keep pace, Keep available, Use it all, Weekdays only und Weekend focus.