# plan-usage

简体中文 | [English](README_en.md)

Un plugin para Claude Code que muestra en la barra de estado el uso de las suscripciones de GLM (ZAI) y MiniMax.

![demo](screenshots/demo.png)

## Características

- 📊 **Seguimiento en tiempo real**: Muestra el porcentaje de uso de GLM y MiniMax
- 🎨 **Alertas de color**: Verde (0-70%), Amarillo (70-90%), Rojo (90-100%)
- ⚡ **Consultas rápidas**: Obtención paralela asíncrona de ambas APIs
- 🔧 **Configuración flexible**: Soporta ver solo GLM o solo MiniMax

## Instalación

### Método 1: Instalación con npm (recomendado)

```bash
npm install -g @renato97/plan-usage
```

### Método 2: Instalación manual

```bash
mkdir -p ~/.claude/plan-usage
cp -r dist/index.js ~/.claude/plan-usage/
chmod +x ~/.claude/plan-usage/index.js
```

## Configurar Claude Code

Edita `~/.claude/settings.json`:

```json
{
  "statusLine": {
    "type": "command",
    "command": "plan-usage"
  }
}
```

O usa la ruta completa:

```json
{
  "statusLine": {
    "type": "command",
    "command": "node ~/.claude/plan-usage/index.js"
  }
}
```

## Variables de entorno

```bash
# GLM API Key (también usa ANTHROPIC_AUTH_TOKEN)
export GLM_API_KEY="tu-clave-api-glm"

# MiniMax API Key (opcional)
export MINIMAX_API_KEY="tu-clave-api-minimax"
```

## Uso

```bash
# Mostrar barra de estado (por defecto)
plan-usage

# Solo mostrar GLM
plan-usage --glm

# Solo mostrar MiniMax
plan-usage --minimax

# Salida en formato JSON
plan-usage --json
```

## Ejemplo de salida

```
GLM 6%  |  MiniMax 93% 1.6h
```

Leyenda de colores:
- 🟢 Verde: 0-70%
- 🟡 Amarillo: 70-90%
- 🔴 Rojo: 90-100%

## Endpoints de API

- **GLM**: `https://api.z.ai/api/monitor/usage/quota/limit`
- **MiniMax**: `https://api.minimax.io/v1/api/openplatform/coding_plan/remains`
- **Kimi**: `https://api.kimi.com/coding/v1/usages`

## Construcción

```bash
# Ejecutar localmente
node dist/index.js

# Probar
node dist/index.js --json
```

## Licencia

MIT