free-code

Command reference — every slash command, keyboard shortcut, and CLI flag.

Editor commands ( `/` )

Type / in the input to open the command menu. Extensions and skills add more.

Session

Command	Description
`/login` · `/logout`	OAuth authentication
`/new`	New session
`/resume`	Browse and pick a previous session
`/name <name>`	Set a visible name for the current session
`/session`	Show session info: path, token count, cost
`/fork`	Branch the current session into a new independent one
`/tree`	Navigate history as a tree and jump to any checkpoint
`/compact [instructions]`	Summarize context; optional instructions for the summary
`/copy`	Copy the last assistant reply to clipboard
`/export [file]`	`.md` → Markdown; `.jsonl` → JSONL; other/none → interactive HTML
`/share`	Upload as a private GitHub gist with an HTML link
`/quit`	Quit the session

Model & settings

Command	Description
`/model`	Switch model interactively
`/scoped-models`	Enable or disable models for the Ctrl+P cycle
`/settings`	Reasoning level, theme, message delivery, transport
`/pick-theme`	Switch the UI theme
`/reload`	Reload shortcuts, extensions, skills, prompts, and context files
`/hotkeys`	List all keyboard shortcuts
`/changelog`	View version history

Tools

Command	Description
`/tools`	List active tools
`/pick-tools`	Enable or disable individual tools
`/files`	Browse and attach files as context
`/pick-agent`	Switch agent preset
`/pick-skill`	Activate a skill interactively
`/commands`	List all available slash commands
`/mcp-import`	Import an MCP server configuration
`/damage-control [on\|off\|toggle\|status]`	Toggle Damage-Control firewall enforcement for bash, paths, and MCP (rules stay loaded)

Subagents

Command	Description
`/sub <task>`	Start a new subagent with a task
`/subcont <n> <prompt>`	Continue talking to subagent #n
`/subrm <n>`	Remove subagent #n
`/subclear`	Clear all subagent widgets

RAG — Knowledge base

Command	Description
`/rag addFile <path>`	Index a document
`/rag addGroup <folder>`	Index all supported files in a folder
`/rag addGithubUrl <url> [subpath]`	Clone a GitHub repo and index its files; optional subpath targets a subdirectory. Saved to `sources.json` for future refreshes.
`/rag addDrive <google_drive_url>`	Download a Google Drive document via `agent_browser` and index it into the active knowledge base (PDF, DOCX, or TXT)
`/rag search <query>`	Query the knowledge base and use the result as context
`/rag list`	List indexed documents
`/rag remove <file>`	Remove a document from the index
`/rag refresh`	Re-fetch and re-index all sources registered via `addFile` and `addGithubUrl`
`/rag schedule [daily\|weekly]`	Set up automatic recurring refresh (requires at least one GitHub source)
`/rag-kb create <name>`	Create a named knowledge base
`/rag-kb delete <name>`	Delete a knowledge base
`/rag-kb use <name>`	Switch the active knowledge base
`/rag-kb list`	List all knowledge bases

Browser & Gemini

Command	Description
`/drive download <url>`	Download a Google Drive document to the project directory via `agent_browser` (PDF, DOCX, or TXT)
`/browse [url] [goal]`	Open URL in visible browser; defaults to Google if no URL
`/gemini ask <message>`	Send a message to Gemini via CDP
`/gemini download <file>`	Download a Gemini-generated artifact
`/gemini open [chat_id]`	Open a Gemini conversation in the browser

Code Graph

Command	Description
`/codeGraph-index [--force]`	Index or re-index the project. `--force` re-indexes all files.
`/codeGraph-symbols <query> [--kind <type>] [--limit <n>]`	Search symbols by name. Kinds: function, class, method, interface, type, variable, enum.
`/codeGraph-callers <name> [--limit <n>]`	Find all call sites for a function or method
`/codeGraph-context <name> [--file <partial-path>]`	Full source and direct callees of a symbol

Code graph full documentation →

Keyboard shortcuts

Customizable via keybindings.json. Run /reload after editing.

Key	Action
Ctrl+C	Clear the editor
Ctrl+C twice	Quit
Escape	Cancel / abort the current operation
Escape twice	Open `/tree`
Ctrl+L	Open model selector
Ctrl+P	Cycle scoped models forward
Shift+Ctrl+P	Cycle scoped models backward
Shift+Tab	Cycle reasoning level (off → minimal → … → xhigh)
Ctrl+O	Collapse / expand tool output
Ctrl+T	Collapse / expand thinking blocks

Editor shortcuts
In the input: type @ to attach files, !command to run a shell command inline, !!command to run and attach output as context.

CLI flags

free-code [options] [@files...] [message...]

Sessions

Flag	Description
`-c`, `--continue`	Continue the most recent session
`-r`, `--resume`	Browse and pick a session
`--session <path\|id>`	Open a specific session by file path or partial UUID
`--fork <path\|id>`	Fork a session into a new one
`--session-dir <dir>`	Custom session storage directory
`--no-session`	Ephemeral mode — nothing is saved

Model & output

Flag	Description
`--provider <name>`	Select provider
`--model <pattern>`	Model ID or `provider/id`, optionally with `:<thinking>`
`--api-key <key>`	API key override
`--thinking <level>`	Reasoning level: off, minimal, low, medium, high, xhigh
`--models <patterns>`	Comma-separated list for Ctrl+P cycle
`--list-models [search]`	List available models; optional search filter
`-p`, `--print`	Single response and exit; reads piped stdin
`--mode json`	JSON line-by-line output
`--mode rpc`	RPC mode (used by VS Code plugin and macOS app)
`--export <session> [output]`	Export session to HTML, Markdown, or JSONL without opening TUI

Tools & extensions

Flag	Description
`--tools <list>`	Built-in tools to enable (default: read,bash,edit,write,grep,find,ls)
`--no-tools`	Disable built-in tools (extension tools still load)
`-e <source>`, `--extension <source>`	Load an extension (repeatable)
`--no-extensions`	Disable extension auto-discovery
`--skill <path>`	Load a skill file (repeatable)
`--no-skills`	Disable skill loading
`--system-prompt <text>`	Replace the default system prompt
`--append-system-prompt <text>`	Append to the default system prompt

Package management

Command	Description
`free-code install <source> [-l]`	Install a package. `-l` = project-local
`free-code remove <source>`	Uninstall a package
`free-code update [source]`	Update installed packages (skips pinned versions)
`free-code list`	List installed packages
`free-code config`	Enable or disable package resources

Built-in agent tools

Available by default in every session. Enable or disable with --tools.

Tool	Description
`read`	Read files from the filesystem
`bash`	Run shell commands
`edit`	Make exact string replacements in files
`write`	Write or overwrite files
`grep`	Search file contents with regex
`find`	Find files by name or pattern
`ls`	List directory contents
`code_index`	Build or update the code graph index
`code_symbols`	Search symbols in the code graph
`code_callers`	Find callers of a function in the code graph
`code_context`	Get symbol source and callees from the code graph

free-code

Referencia de comandos — todos los slash commands, atajos de teclado y flags de la CLI.

Comandos del editor ( `/` )

Escribe / en el campo de entrada para abrir el menú de comandos. Las extensiones y skills agregan más.

Sesión

Comando	Descripción
`/login` · `/logout`	Autenticación OAuth
`/new`	Nueva sesión
`/resume`	Explorar y elegir una sesión anterior
`/name <name>`	Establecer un nombre visible para la sesión actual
`/session`	Mostrar información de la sesión: ruta, cantidad de tokens, costo
`/fork`	Ramificar la sesión actual en una nueva independiente
`/tree`	Navegar el historial como un árbol y saltar a cualquier checkpoint
`/compact [instructions]`	Resumir el contexto; instrucciones opcionales para el resumen
`/copy`	Copiar la última respuesta del asistente al portapapeles
`/export [file]`	`.md` → Markdown; `.jsonl` → JSONL; otro/ninguno → HTML interactivo
`/share`	Subir como gist privado de GitHub con un enlace HTML
`/quit`	Salir de la sesión

Modelo y configuración

Comando	Descripción
`/model`	Cambiar de modelo de forma interactiva
`/scoped-models`	Habilitar o deshabilitar modelos para el ciclo con Ctrl+P
`/settings`	Nivel de razonamiento, tema, entrega de mensajes, transporte
`/pick-theme`	Cambiar el tema de la interfaz
`/reload`	Recargar atajos, extensiones, skills, prompts y archivos de contexto
`/hotkeys`	Listar todos los atajos de teclado
`/changelog`	Ver el historial de versiones

Herramientas

Comando	Descripción
`/tools`	Listar herramientas activas
`/pick-tools`	Habilitar o deshabilitar herramientas individuales
`/files`	Explorar y adjuntar archivos como contexto
`/pick-agent`	Cambiar el preset de agente
`/pick-skill`	Activar una skill de forma interactiva
`/commands`	Listar todos los slash commands disponibles
`/mcp-import`	Importar la configuración de un servidor MCP
`/damage-control [on\|off\|toggle\|status]`	Activar o desactivar la aplicación del firewall Damage-Control para bash, rutas y MCP (las reglas permanecen cargadas)

Subagentes

Comando	Descripción
`/sub <task>`	Iniciar un nuevo subagente con una tarea
`/subcont <n> <prompt>`	Continuar hablando con el subagente #n
`/subrm <n>`	Eliminar el subagente #n
`/subclear`	Limpiar todos los widgets de subagentes

RAG — Base de conocimiento

Comando	Descripción
`/rag addFile <path>`	Indexar un documento
`/rag addGroup <folder>`	Indexar todos los archivos compatibles de una carpeta
`/rag addGithubUrl <url> [subpath]`	Clonar un repositorio de GitHub e indexar sus archivos; el subpath opcional apunta a un subdirectorio. Se guarda en `sources.json` para futuras actualizaciones.
`/rag addDrive <google_drive_url>`	Descargar un documento de Google Drive mediante `agent_browser` e indexarlo en la base de conocimiento activa (PDF, DOCX o TXT)
`/rag search <query>`	Consultar la base de conocimiento y usar el resultado como contexto
`/rag list`	Listar documentos indexados
`/rag remove <file>`	Quitar un documento del índice
`/rag refresh`	Volver a obtener e indexar todas las fuentes registradas mediante `addFile` y `addGithubUrl`
`/rag schedule [daily\|weekly]`	Configurar una actualización automática recurrente (requiere al menos una fuente de GitHub)
`/rag-kb create <name>`	Crear una base de conocimiento con nombre
`/rag-kb delete <name>`	Eliminar una base de conocimiento
`/rag-kb use <name>`	Cambiar la base de conocimiento activa
`/rag-kb list`	Listar todas las bases de conocimiento

Navegador y Gemini

Comando	Descripción
`/drive download <url>`	Descargar un documento de Google Drive al directorio del proyecto mediante `agent_browser` (PDF, DOCX o TXT)
`/browse [url] [goal]`	Abrir una URL en un navegador visible; usa Google por defecto si no hay URL
`/gemini ask <message>`	Enviar un mensaje a Gemini mediante CDP
`/gemini download <file>`	Descargar un artefacto generado por Gemini
`/gemini open [chat_id]`	Abrir una conversación de Gemini en el navegador

Grafo de código

Comando	Descripción
`/codeGraph-index [--force]`	Indexar o reindexar el proyecto. `--force` reindexa todos los archivos.
`/codeGraph-symbols <query> [--kind <type>] [--limit <n>]`	Buscar símbolos por nombre. Tipos: function, class, method, interface, type, variable, enum.
`/codeGraph-callers <name> [--limit <n>]`	Encontrar todos los puntos de llamada de una función o método
`/codeGraph-context <name> [--file <partial-path>]`	Código fuente completo y llamadas directas de un símbolo

Documentación completa del grafo de código →

Atajos de teclado

Personalizables mediante keybindings.json. Ejecuta /reload después de editar.

Tecla	Acción
Ctrl+C	Limpiar el editor
Ctrl+C dos veces	Salir
Escape	Cancelar / interrumpir la operación actual
Escape dos veces	Abrir `/tree`
Ctrl+L	Abrir el selector de modelo
Ctrl+P	Recorrer los modelos con alcance hacia adelante
Shift+Ctrl+P	Recorrer los modelos con alcance hacia atrás
Shift+Tab	Recorrer el nivel de razonamiento (off → minimal → … → xhigh)
Ctrl+O	Contraer / expandir la salida de herramientas
Ctrl+T	Contraer / expandir los bloques de pensamiento

Atajos del editor
En el campo de entrada: escribe @ para adjuntar archivos, !command para ejecutar un comando de shell en línea, !!command para ejecutarlo y adjuntar la salida como contexto.

Flags de la CLI

free-code [options] [@files...] [message...]

Sesiones

Flag	Descripción
`-c`, `--continue`	Continuar la sesión más reciente
`-r`, `--resume`	Explorar y elegir una sesión
`--session <path\|id>`	Abrir una sesión específica por ruta de archivo o UUID parcial
`--fork <path\|id>`	Ramificar una sesión en una nueva
`--session-dir <dir>`	Directorio personalizado de almacenamiento de sesiones
`--no-session`	Modo efímero — no se guarda nada

Modelo y salida

Flag	Descripción
`--provider <name>`	Seleccionar proveedor
`--model <pattern>`	ID del modelo o `provider/id`, opcionalmente con `:<thinking>`
`--api-key <key>`	Sobrescribir la API key
`--thinking <level>`	Nivel de razonamiento: off, minimal, low, medium, high, xhigh
`--models <patterns>`	Lista separada por comas para el ciclo con Ctrl+P
`--list-models [search]`	Listar modelos disponibles; filtro de búsqueda opcional
`-p`, `--print`	Una sola respuesta y salir; lee stdin por pipe
`--mode json`	Salida en JSON línea por línea
`--mode rpc`	Modo RPC (usado por el plugin de VS Code y la app de macOS)
`--export <session> [output]`	Exportar la sesión a HTML, Markdown o JSONL sin abrir la TUI

Herramientas y extensiones

Flag	Descripción
`--tools <list>`	Herramientas integradas a habilitar (por defecto: read,bash,edit,write,grep,find,ls)
`--no-tools`	Deshabilitar herramientas integradas (las herramientas de extensiones se siguen cargando)
`-e <source>`, `--extension <source>`	Cargar una extensión (repetible)
`--no-extensions`	Deshabilitar el autodescubrimiento de extensiones
`--skill <path>`	Cargar un archivo de skill (repetible)
`--no-skills`	Deshabilitar la carga de skills
`--system-prompt <text>`	Reemplazar el system prompt por defecto
`--append-system-prompt <text>`	Agregar contenido al system prompt por defecto

Gestión de paquetes

Comando	Descripción
`free-code install <source> [-l]`	Instalar un paquete. `-l` = local al proyecto
`free-code remove <source>`	Desinstalar un paquete
`free-code update [source]`	Actualizar los paquetes instalados (omite versiones fijadas)
`free-code list`	Listar paquetes instalados
`free-code config`	Habilitar o deshabilitar recursos del paquete

Herramientas integradas del agente

Disponibles por defecto en cada sesión. Habilítalas o deshabilítalas con --tools.

Herramienta	Descripción
`read`	Leer archivos del sistema de archivos
`bash`	Ejecutar comandos de shell
`edit`	Hacer reemplazos exactos de texto en archivos
`write`	Escribir o sobrescribir archivos
`grep`	Buscar contenido de archivos con regex
`find`	Buscar archivos por nombre o patrón
`ls`	Listar el contenido de un directorio
`code_index`	Construir o actualizar el índice del grafo de código
`code_symbols`	Buscar símbolos en el grafo de código
`code_callers`	Encontrar quién llama a una función en el grafo de código
`code_context`	Obtener el código fuente y las llamadas de un símbolo desde el grafo de código

Editor commands ( / )

Session

Model & settings

Tools

Subagents

RAG — Knowledge base

Browser & Gemini

Code Graph

Keyboard shortcuts

CLI flags

Sessions

Model & output

Tools & extensions

Package management

Built-in agent tools

Comandos del editor ( / )

Sesión

Modelo y configuración

Herramientas

Subagentes

RAG — Base de conocimiento

Navegador y Gemini

Grafo de código

Atajos de teclado

Flags de la CLI

Sesiones

Modelo y salida

Herramientas y extensiones

Gestión de paquetes

Herramientas integradas del agente

Editor commands ( `/` )

Comandos del editor ( `/` )