Ajustes ​

GraphoOS se configura en settings.toml (ábrelo con Abrir el fichero de ajustes, o usa la página de ajustes: Abrir los ajustes, que tiene buscador). Cada clave de abajo va en su [sección]; el valor que se muestra es el de por defecto. Es TOML, no JSON: los comentarios van con #, las cadenas entre comillas, y una clave que falta es el valor por defecto.

Dónde viven los ajustes ​

• Los tuyos, en la carpeta de configuración: Abrir el fichero de ajustes. Ese es el fichero de esta máquina. Al lado viven keymaps.toml (Abrir los atajos de teclado), snippets/ (Abrir los fragmentos de usuario), los temas de color que importas, y una carpeta fonts/ para caras que este editor debe cargar sin instalarlas en el sistema.
• Los de este proyecto, en .graphoos/settings.toml: Abrir los ajustes del proyecto, que crea el fichero si no está. Mandan sobre los tuyos mientras la carpeta está abierta, están pensados para ir en el repositorio, y editar el fichero los aplica en el acto, sin volver a abrir la ventana.

La paleta abre siempre el fichero correcto. Si hace falta la ruta (* es el canal de esta build):

• macOS: ~/Library/Application Support/dev.graphoos.GraphoOS*/settings.toml
• Linux: ~/.config/graphoos*/settings.toml
• Windows: %APPDATA%\graphoos\GraphoOS*\settings.toml
• GRAPHOOS_DATA_DIR mueve el perfil entero (ajustes, plugins, cachés, registros) a esa carpeta.

El fichero por defecto empieza con #:schema ../extra/schemas/settings.json. Ese JSON Schema se genera con esta página. Pon la misma directiva apuntando a una copia del esquema para que el editor que abre settings.toml compruebe las claves al escribir.

Un ejemplo que sirve ​

Un fichero de proyecto solo necesita las claves en las que este repositorio no está de acuerdo con los valores por defecto. Las claves de API no van en nada que se suba: usa el entorno o el llavero (véase Claves).

#:schema extra/schemas/settings.json

[editor]
font-size = 13
tab-width = 4
format-on-save = true
rulers = [100]
files-exclude = "**/{.git,node_modules,target,dist,.venv}"

[editor.formatters]
rust = "rustfmt --edition 2024"
python = "black -q -"
javascript = "prettier --stdin-filepath {file}"

[terminal]
font-size = 13

[terminal.env]
EDITOR = "graphoos --wait"

[ui]
language = "es"
density = "Compact"

[ai]
offline = false
chat-provider = "local"
inline-completion-provider = "local"

Si vienes de VS Code ​

Importar los ajustes de VS Code lee tu settings.json y el .vscode/settings.json de este proyecto (con comentarios y comas finales) y escribe las claves que aquí significan lo mismo: letra, ancho del tabulador, reglas, ajuste de línea, formato al guardar, migas de pan, guías de sangría, cabeceras fijas, pistas en línea, autoguardado y la letra de la terminal. Lo demás se lista por su nombre en vez de adivinarlo, para que nada llegue convertido en algo que no es. Lo que ya había en tu fichero se conserva.

El teclado de VS Code ​

Importar los atajos de VS Code lee su keybindings.json y añade a tu fichero de atajos los que tienen aquí un comando, conservando lo que ya hay: cmd pasa a ser meta, los acordes siguen siendo acordes (cmd+k cmd+s), se conserva el when de cada uno, y cada comando sin equivalente se nombra en el mensaje en vez de desaparecer en silencio: un atajo que calladamente no hace nada es peor que uno que falta.

Un tema de VS Code ​

Importar un tema de color de VS Code toma el .json del tema abierto en el editor —uno de una extensión, o el que VS Code escribe con Generate Color Theme From Current Settings— y lo escribe como tema nuestro en la carpeta de temas, pasando los colors y los ámbitos TextMate de tokenColors a las claves de aquí. Después aparece en Cambiar el tema de color. Lo que no tiene equivalente se cuenta, no se adivina.

Generado por scripts/gen_docs.py desde el código del editor; edita eso, no este fichero.

[core] — Núcleo ​

Edición modal, temas y la ventana.

[editor] — Editor ​

Letra, ajuste de línea, autocompletado, formato, blame y más.

[terminal] — Terminal ​

La terminal integrada y sus perfiles.

[ui] — Interfaz ​

Letra y tamaños de la interfaz, los paneles y las pestañas.

[ai] — IA ​

Proveedores de AiloOS, el asistente, el agente y el texto fantasma.

[editor.formatters] ​

Formateadores externos por id de lenguaje: una orden que lee el fichero por la entrada estándar y escribe el texto formateado por la salida ({file} en la orden se sustituye por la ruta). Los usan Formatear el documento y el formato al guardar cuando el servidor de lenguaje no tiene formateador. Si un lenguaje tiene una entrada aquí, se usa en lugar del servidor de lenguaje.

[editor.formatters]
rust = "rustfmt --edition 2024"
python = "black -q -"
go = "gofmt"
javascript = "prettier --stdin-filepath {file}"

[terminal.profiles] y [terminal.env] ​

Shells con nombre para el panel de la terminal. [terminal.default-profile] elige uno por sistema (macos, linux, windows). Cada perfil puede fijar command, arguments, environment y workdir.

[terminal.default-profile]
macos = "default"
linux = "default"
windows = "default"

[terminal.profiles]
default = {}

[terminal.profiles.cargo]
command = "cargo"
arguments = ["run"]
workdir = "/home/user"
environment = { KEY = "VALUE" }

[terminal.env] se añade a cada terminal. [terminal.env-macos], [terminal.env-linux] y [terminal.env-windows] mandan en ese sistema, igual que terminal.integrated.env.* de VS Code. El resto del panel está en Terminal.

Ajustes de los plugins ​

Cada plugin añade su propia sección con su nombre (por ejemplo [graphoos-c]), con las claves que declara su volt.toml; la página del plugin en el panel de plugins las edita. Cómo escribir uno: Escribir un plugin.

El resto del proyecto ​

settings.toml es solo el editor. Los desarrolladores también guardan estos ficheros junto al proyecto. El detalle está en las páginas enlazadas; esta tabla es el mapa.

Asistente, agente, índice y MCP: Asistente e IA.

Markdown para copiar ​

Pégalos tal cual. El asistente los lee como instrucciones (no como datos adjuntos). Cada bloque es un fichero.

AGENTS.md — raíz del proyecto. Viaja con cada mensaje, antes de .graphoos/rules.

# Agente

- Usa las herramientas del propio proyecto (`cargo`, `npm`, `make`).
- No subas secretos, claves de API ni `.env`.
- Tras un cambio de código, ejecuta la comprobación del proyecto (`cargo test`, `npm test`, …) antes de dar la tarea por hecha.

.graphoos/rules.md — reglas extra de este editor. .graphoos/rules/*.md se concatenan detrás.

Responde en el idioma de la petición.
Diffs pequeños. No refactorices ficheros que no te hayan pedido tocar.

.graphoos/memory.md — /remember <nota> añade una línea con fecha. Edítalo libremente.

# Memoria

<!-- `/remember` escribe aquí. El asistente lee este fichero con las reglas del proyecto. -->

.graphoos/spec.md — /spec crea esta plantilla y la abre. El agente la lee antes de cada tarea.

# Especificación — {project}

<!-- El agente lee este fichero antes de tocar código y pregunta si falta algo. -->

## Objetivo

<!-- Qué problema resuelve el cambio y para quién, en dos frases. -->

## Invariantes

<!-- Lo que NUNCA puede romperse. Una línea por invariante, comprobable. -->
- 

## Criterios de aceptación

<!-- Cómo se sabe que está hecho. Cada uno debería poder ser un test. -->
- [ ] 

## Fuera de alcance

<!-- Lo que el agente no debe tocar aunque parezca relacionado. -->
- 

## Notas

.graphoos/skills/rust-tests.md — una skill. name, description y triggers en el frontmatter; el cuerpo es el procedimiento. Copia de usuario: ~/.ailoos/skills/.

---
name: rust-tests
description: Cómo ejecutar y escribir los tests Rust de este proyecto
triggers: [test, cargo test]
---
1. `cargo test` en la raíz del proyecto.
2. Si un test falla, lee el fichero y la aserción antes de cambiar nada más.
3. No ignores un test que falla para dejar la suite en verde.

.graphoos/first-prompt.md — Nuevo proyecto… → Descríbeselo al agente escribe aquí tu descripción. El fichero es el prompt, sin más.

Haz un CLI que lea una carpeta e imprima el árbol de sus ficheros. Rust, clap, tests.

Claves, fuera del TOML ​

No subas claves de API en .graphoos/settings.toml.

• ai.ailoos-api-key vacía → AILOOS_API_KEY.
• ai.custom-api-key vacía → GRAPHOOS_AI_API_KEY.
• [ai.providers.<name>] con api-key vacía → la clave que guarda IA: guardar una clave de API en el llavero… (el llavero del sistema, no el fichero).
• ai.offline = true no contacta nunca con AiloOS en la nube; solo contesta el servidor local (ai.local-endpoint, por defecto http://127.0.0.1:8080/v1).

El asistente borra secretos reconocibles antes de que el texto salga de la máquina. Las claves van en el entorno o en el llavero, no en un fichero del repositorio.

Véase también ​

• Atajos de teclado
• Terminal
• Ejecutar y depurar
• Asistente e IA
• Escribir un plugin

Fuente: docs/es/settings.md