Codex Gestion
A local VS Code dashboard for Codex quotas, sessions, and account switching.
English
Leer en español
Codex Gestion gives Codex power users a clean local view of usage, quota windows,
account snapshots, and account switching inside VS Code. It is built for the
small but very real moment where you want to know: which account am I using,
how much quota is left, and when does it reset?
New in 0.0.5
- Smarter project handoff context for continuing work in another chat or account.
- Optional local Codex session excerpts in
.codex-gestion/PROJECT_CONTEXT.md through codexGestion.projectContext.includeSessionExcerpts.
- Project context now includes Git status and a clearer next-chat continuation prompt.
- Compact status bar now shows available quota plus the real time left to reset.
- Logo PNG now has transparent rounded corners for Marketplace and VS Code views.
- Reset times no longer show stale
in now / dentro de now text.
Preview
| Dashboard |
Status tooltip |
 |
 |
Highlights
| Area |
What it does |
| Quotas |
Shows primary and secondary Codex quota windows when Codex records them locally. |
| Dashboard |
Opens a polished Chart.js dashboard with availability gauges and reset times. |
| Status bar |
Adds a compact status-bar summary and visual tooltip for quick checks. |
| Accounts |
Stores local account credentials in VS Code SecretStorage and lets you switch accounts. |
| Switching |
Reloads VS Code automatically after a successful switch and guards against Codex restoring the previous account. |
| Handoff |
Maintains a local project context file at .codex-gestion/PROJECT_CONTEXT.md, with optional sanitized session excerpts for account/chat handoff. |
| Diagnostics |
Generates sanitized troubleshooting output without tokens or full chat contents. |
Privacy-first by design
Codex Gestion is a local helper. It is not a hosted service and it does not need
a backend.
It reads:
~/.codex/sessions/**/*.jsonl~/.codex/auth.json- VS Code SecretStorage entries created by this extension
- the current workspace path when creating project context
- recent local Codex session excerpts when project context excerpts are enabled
It writes:
~/.codex/auth.json when you explicitly add or switch accounts- VS Code SecretStorage entries for saved account credentials
.codex-gestion/PROJECT_CONTEXT.md in the current workspace, optionally including sanitized local session excerpts
It does not intentionally send tokens, credentials, prompts, file contents,
session contents, or diagnostics to any remote server. Session excerpts, when enabled, are written only to the local project context file. See PRIVACY.md for
the full policy.
Installation
From the Marketplace, search for:
Codex Gestion
From a local VSIX package:
code --install-extension .\dist\codex-gestion-0.0.5.vsix --force
Commands
| Command |
Purpose |
Codex Gestion: Open visual panel |
Open the visual dashboard. |
Codex Gestion: Refresh |
Refresh local usage data. |
Codex Gestion: Manage accounts |
Add, switch, rename, or remove local accounts. |
Codex Gestion: Switch account |
Switch directly between saved accounts. |
Codex Gestion: Open project context |
Create or open the handoff context file. |
Codex Gestion: View diagnostics |
Show sanitized diagnostic output. |
Language
Codex Gestion supports English and Spanish. Use codexGestion.language to choose:
auto | es | en
auto follows the VS Code display language.
Multiple accounts
Codex threads cannot combine context windows or rate limits from multiple
accounts. When you switch accounts, Codex Gestion updates the local auth file,
waits briefly to protect the selection, and reloads VS Code so new Codex work
starts from the selected account cleanly.
Support the project
Codex Gestion is free. If it saves you time, donations are welcome but optional.
Donations do not unlock extra features; they just help keep maintenance moving.
See DONATE.md for details.
License
Codex Gestion is source-available. You may install and use the official extension,
and view the source for transparency, but copying, modifying, redistributing,
repackaging, or publishing derivative extensions is not permitted without written
permission. See LICENSE.
Español
Read in English
Codex Gestion ofrece a usuarios intensivos de Codex una vista local y clara de
uso, ventanas de cuota, cuentas detectadas y cambio de cuenta dentro de VS Code.
Esta pensada para ese momento concreto en el que quieres saber: que cuenta estoy
usando, cuanta cuota queda y cuando se renueva?
Nuevo en 0.0.5
- Contexto de traspaso mas inteligente para continuar el trabajo en otro chat o cuenta.
- Extractos opcionales de sesiones locales de Codex en
.codex-gestion/PROJECT_CONTEXT.md mediante codexGestion.projectContext.includeSessionExcerpts.
- El contexto del proyecto ahora incluye estado Git y un prompt de continuacion mas claro.
- La barra compacta ahora muestra la cuota disponible y el tiempo real que falta para renovar.
- El PNG del logo ahora tiene esquinas redondeadas transparentes para Marketplace y VS Code.
- Las renovaciones antiguas ya no muestran textos confusos como
in now / dentro de now.
Vista previa
| Panel visual |
Tooltip de estado |
|
|
Caracteristicas
| Area |
Que hace |
| Cuotas |
Muestra las ventanas de cuota principal y secundaria cuando Codex las registra localmente. |
| Panel visual |
Abre un panel Chart.js cuidado con graficas de disponibilidad y horas de renovacion. |
| Barra de estado |
Anade un resumen compacto y un tooltip visual para consultas rapidas. |
| Cuentas |
Guarda credenciales locales en VS Code SecretStorage y permite cambiar entre cuentas. |
| Cambio de cuenta |
Recarga VS Code automaticamente tras un cambio correcto y evita que Codex restaure la cuenta anterior. |
| Traspaso |
Mantiene un archivo local de contexto en .codex-gestion/PROJECT_CONTEXT.md, con extractos saneados opcionales para cambiar de cuenta o chat. |
| Diagnostico |
Genera informacion de ayuda saneada, sin tokens ni contenido completo de chats. |
Privacidad primero
Codex Gestion es una ayuda local. No es un servicio alojado y no necesita backend.
Lee:
~/.codex/sessions/**/*.jsonl~/.codex/auth.json- entradas de VS Code SecretStorage creadas por esta extension
- la ruta del workspace actual al crear contexto de proyecto
- extractos recientes de sesiones locales de Codex si los extractos de contexto estan activados
Escribe:
~/.codex/auth.json cuando agregas o cambias cuentas explicitamente- entradas de VS Code SecretStorage para credenciales guardadas
.codex-gestion/PROJECT_CONTEXT.md en el workspace actual, opcionalmente con extractos saneados de sesiones locales
No envia intencionadamente tokens, credenciales, prompts, contenidos de archivos,
contenidos de sesiones ni diagnosticos a ningun servidor remoto. Los extractos de sesion, si estan activados, solo se escriben en el archivo local de contexto del proyecto. Consulta
PRIVACY.md para ver la politica completa.
Instalacion
Desde el Marketplace, busca:
Codex Gestion
Desde un paquete VSIX local:
code --install-extension .\dist\codex-gestion-0.0.5.vsix --force
Comandos
| Comando |
Uso |
Codex Gestion: Abrir panel visual |
Abrir el panel visual. |
Codex Gestion: Actualizar |
Actualizar los datos locales de uso. |
Codex Gestion: Gestionar cuentas |
Agregar, cambiar, renombrar o eliminar cuentas locales. |
Codex Gestion: Cambiar cuenta |
Cambiar directamente entre cuentas guardadas. |
Codex Gestion: Abrir contexto del proyecto |
Crear o abrir el archivo de contexto de traspaso. |
Codex Gestion: Ver diagnostico |
Mostrar diagnostico saneado. |
Idioma
Codex Gestion soporta ingles y espanol. Usa codexGestion.language para elegir:
auto | es | en
auto sigue el idioma configurado en VS Code.
Multiples cuentas
Los hilos de Codex no pueden combinar ventanas de contexto ni limites de varias
cuentas. Al cambiar de cuenta, Codex Gestion actualiza el archivo local de auth,
espera brevemente para proteger la seleccion y recarga VS Code para que el nuevo
trabajo de Codex empiece limpiamente con la cuenta seleccionada.
Apoyar el proyecto
Codex Gestion es gratis. Si te ahorra tiempo, las donaciones son bienvenidas pero opcionales.
Las donaciones no desbloquean funciones extra; solo ayudan a mantener el proyecto.
Consulta DONATE.md para mas detalles.
Licencia
Codex Gestion es source-available. Puedes instalar y usar la extension oficial,
y revisar el codigo por transparencia, pero no esta permitido copiar, modificar,
redistribuir, reempaquetar ni publicar extensiones derivadas sin permiso escrito.
Consulta LICENSE.
