Ceroclaw CLI

Agente de IA para tu terminal. Escribí código, explorá repositorios y automatizá tareas — desde la línea de comandos, con los modelos que elijas.

→ ceroclawd.com

Instalación

npm install -g @ceroclaw/cli

Requiere Node.js 20+

Inicio rápido

ceroclaw

Al iniciarlo por primera vez, te pide que configures un proveedor de IA con /auth.

Proveedores de IA

Ceroclaw soporta múltiples proveedores. Configurá el que prefieras desde /auth.

ChatGPT Plus / Pro (OAuth)

Usá tu suscripción de ChatGPT sin necesitar una API key.

1. Corré ceroclaw y abrí /auth
2. Seleccioná ChatGPT Plus/Pro (OAuth)
3. Se abre el navegador — iniciá sesión con tu cuenta de ChatGPT
4. Listo

Modelos disponibles: gpt-5.4, gpt-5.4-mini, gpt-5.3-codex, gpt-5.2-codex, gpt-5.2

Requiere suscripción activa de ChatGPT Plus o Pro.

GLM / Z.AI

Modelos GLM de Zhipu AI a través de la API de Z.AI.

1. Creá una cuenta en bigmodel.cn y generá una API key
2. En /auth, seleccioná GLM / Z.AI
3. Ingresá tu API key

Modelos disponibles: glm-5.1, glm-4.7, glm-4.6

OpenAI API Key

Acceso directo a los modelos de OpenAI con tu propia API key.

1. Obtené una API key en platform.openai.com
2. En /auth, seleccioná OpenAI API Key
3. Ingresá tu API key (sk-...)

Modelos disponibles: gpt-4.1, gpt-4.1-mini, gpt-4o, o4-mini

Ceroclawd OAuth

Acceso gratuito con límite de 1.000 requests/día usando cuenta Ceroclawd.

1. En /auth, seleccioná Ceroclawd OAuth
2. Se abre el navegador para autenticarte
3. Listo

Alibaba Cloud Coding Plan

Para usuarios con plan de Alibaba Cloud Model Studio.

1. Obtené tu API key en la consola de Alibaba Cloud
2. En /auth, seleccioná Alibaba Cloud Coding Plan
3. Elegí tu región y pegá la API key

Custom API Key

Para proveedores compatibles con OpenAI o Anthropic (Gemini, Vertex AI, u otros).

Configurá manualmente en ~/.ceroclawd/settings.json:

{
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "env": {
    "OPENAI_API_KEY": "tu-api-key",
    "OPENAI_BASE_URL": "https://tu-proveedor.com/v1"
  },
  "model": {
    "name": "nombre-del-modelo"
  }
}

Memoria entre sesiones

Ceroclaw incluye un sistema de memoria que guarda el contexto de tus proyectos y sesiones, y lo sincroniza entre máquinas usando GitHub.

Activar memoria cross-machine

1. En /auth, seleccioná Memoria GitHub
2. Se abre el navegador — iniciá sesión con tu cuenta de GitHub
3. Autorizá el acceso (solo se usa el permiso gist para crear un repositorio privado de notas)
4. Listo — tus sesiones se sincronizan automáticamente entre máquinas

La memoria se guarda en un Gist privado de tu cuenta de GitHub. Ceroclaw no tiene acceso a tus datos.

CEROCLAW.md

Al iniciar ceroclaw en cualquier directorio, se crea automáticamente un archivo CEROCLAW.md con el contexto del proyecto. Podés editarlo a mano para agregar información relevante:

# Mi Proyecto

## Stack
- Backend: NestJS + TypeScript
- DB: PostgreSQL con Prisma

## Convenciones
- Tests con Vitest
- Commits en inglés

## Decisiones importantes
- Soft delete en todas las tablas

Este archivo se carga automáticamente en cada sesión. Si lo commiteás al repositorio, todos los miembros del equipo comparten el mismo contexto.

Comandos

Dentro de una sesión interactiva:

| Comando | Descripción | |---------|-------------| | /auth | Configurar proveedor de IA o activar memoria GitHub | | /model | Cambiar el modelo activo | | /sessions | Listar sesiones guardadas | | /sessions search <término> | Buscar en sesiones | | /sessions continue <nombre> | Continuar una sesión anterior | | /sessions new <nombre> | Crear una sesión nueva | | /checkpoint | Guardar el estado de la sesión actual | | /checkpoint <nota> | Guardar con una nota específica | | /memory show | Ver la memoria cargada | | /memory add <texto> | Agregar algo a la memoria | | /clear | Limpiar la conversación | | /help | Ver todos los comandos disponibles |

Cambiar modelo en sesión

/model

Muestra los modelos disponibles según tu proveedor activo y te deja cambiar sin reiniciar.

Modelos locales (Ollama)

Ceroclaw también funciona con modelos locales via Ollama.

# Instalar Ollama desde https://ollama.com
ollama pull qwen2.5-coder:32b-instruct-q4_K_M

Configurá en ~/.ceroclawd/settings.json:

{
  "modelProviders": {
    "ollama": [
      {
        "id": "qwen2.5-coder:32b-instruct-q4_K_M",
        "model": "qwen2.5-coder:32b-instruct-q4_K_M",
        "baseUrl": "http://localhost:11434/v1"
      }
    ]
  }
}

Estructura de archivos

~/.ceroclawd/
  settings.json          ← configuración global
  chatgpt-tokens.json    ← tokens OAuth de ChatGPT (auto-generado)
  github-tokens.json     ← token OAuth de GitHub (auto-generado)
  memory/
    sessions.json        ← índice de sesiones
    session-*.md         ← contenido de cada sesión
    projects.json        ← contexto de proyectos

tu-proyecto/
  CEROCLAW.md            ← memoria del proyecto (podés commitearlo)

Instalación desde fuente

git clone https://github.com/ceroclaw/ceroclaw-cli.git
cd ceroclaw-cli
npm install
node esbuild.config.js
npm link

Licencia

Apache-2.0