Primeros pasos con naos code

Instalar

En Linux (x64), con el ejecutable: no necesitas nada más. Descomprímelo en su propia carpeta y enlázalo desde una carpeta de tu PATH, así sus ayudantes y el aviso de licencia se quedan juntos y fuera de bin:

mkdir -p ~/.local/share/naos ~/.local/bin
tar -xzf naos-code-<versión>-linux-x64.tar.gz -C ~/.local/share/naos
ln -sf ~/.local/share/naos/naos ~/.local/bin/naos

Si naos no se encuentra después, añade ~/.local/bin a tu PATH (por ejemplo, export PATH="$HOME/.local/bin:$PATH" en tu ~/.bashrc). La primera vez que ejecuta un comando guarda unos 2,4 MB en ~/.cache/pkg (una pieza nativa); el resto va dentro del binario.

Con el paquete npm, en Linux y, con Node.js 24.9 o posterior, en macOS y Windows (sin probar aún en macOS y Windows):

npm install -g ./inferencekey-naos-code-<versión>.tgz

Iniciar sesión

Una vez en cada equipo. Se abre el navegador, entras con tu cuenta de Naos y autorizas el equipo. Si el navegador no se abre, naos login --manual te deja pegar el código que muestra la página.

naos login
naos estado

naos estado te dice tu plan y cuánto llevas usado. Para cerrar la sesión en ese equipo, naos salir.

Abrir naos en tu proyecto

Entra en la carpeta de tu proyecto y escribe naos. Escribe lo que necesitas y pulsa Intro; la respuesta aparece mientras se genera. También puedes empezar con la petición directamente:

cd mi-proyecto
naos "añade tests a utils.py"

Mientras Naos responde, Ctrl+C cancela la respuesta y vuelves a escribir. Para una tarea suelta desde un script, sin conversación, usa naos headless "tarea".

Qué apruebas

Antes de cambiar algo, Naos te enseña qué va a hacer y te pregunta:

• Crear un fichero: la ruta y el contenido.
• Reemplazar un fichero: lo que cambia respecto a lo que tiene ahora, con el número de cada línea.
• Editar un fichero: las líneas que quita (-) y las que pone (+), con dos líneas de contexto y, si Naos puede leer el fichero, el número de cada línea.
• Ejecutar un comando: el comando entero, todas sus líneas.
• Abrir una dirección web: la dirección completa.

Respondes s (sí, solo esta vez), n (no: Naos le dice al modelo que no lo haga) o t (sí a todo hasta que escribas /nuevo). Si no entiendes lo que pide, responde n.

Si no cabe entero en la pantalla, Naos enseña una parte de lo que quita y otra de lo que pone y avisa: «No cabe entero (N líneas más): pulsa v para verlo antes de responder.». Con v (ver todo) lo pinta entero y vuelve a preguntar; puedes pulsarla las veces que quieras.

Los comandos se ejecutan aislados en la carpeta del proyecto. Si uno pide salir de ese aislamiento, Naos lo avisa en rojo con el motivo y pregunta siempre, también con sí a todo. Después de aprobar ves el resultado: las últimas líneas de la salida del comando, o «Escrito hola.py (+12 -3)» con las líneas añadidas y quitadas.

Comandos

• /ayuda: la ayuda, con estos comandos.
• /estado: tu plan, cuánto llevas usado y la key de este equipo.
• /nuevo: empieza una conversación nueva (y vuelve a preguntar todo).
• /continuar: vuelve a la conversación anterior de esta carpeta. Si tenías otra abierta, queda guardada: /continuar otra vez vuelve a ella.
• /salir o Ctrl+D: cierra naos. Ctrl+C con la línea vacía pide confirmación: pulsa Ctrl+C otra vez para salir.

Dónde se guardan tus conversaciones

Solo en tu equipo, nunca en el servidor de Naos: en ~/.naos/sessions (o en $NAOS_HOME/sessions si cambiaste la carpeta de naos), con todo lo que se dijo y los ficheros que se leyeron. Para borrarlas, cierra naos y ejecuta este comando: borra esa carpeta y todo lo que naos guarda de ellas fuera de ella, y te dice cuántas ha borrado. Tu sesión y tu configuración se quedan.

naos olvidar

Privacidad

Lo que escribes y lo que Naos lee de tu carpeta va al modelo a través de Naos: inferencekey ejecuta el modelo en sus propios servidores, mide el consumo y no lo envía a ningún proveedor de modelos externo.

Leer ficheros no pide permiso. Naos puede leer cualquier fichero de la carpeta donde lo abres para entender tu código, también un .env con secretos. Ábrelo solo en carpetas cuyo contenido quieras enviar al modelo, nunca en tu carpeta personal entera.

Extensión de VS Code

Naos también funciona dentro de VS Code, con la misma cuenta y el mismo plan. Descarga el fichero .vsix en la página de Descargas e instálalo con este comando, o desde VS Code: en Extensiones, el menú de los tres puntos y «Instalar desde VSIX...» («Install from VSIX...» si tienes VS Code en inglés).

Ir a Descargas

code --install-extension naos-vscode-<versión>.vsix

Iniciar sesión. Abre la vista de Naos en la barra lateral y pulsa «Iniciar sesión con Naos». El navegador te pide que autorices el equipo y VS Code vuelve solo. La primera vez, VS Code pregunta «Allow 'Naos' extension to open this URI?» (¿permitir que la extensión Naos abra esta dirección?): pulsa Open. Es un aviso de seguridad de VS Code; si marcas «Do not ask me again for this extension» (no volver a preguntar por esta extensión), no vuelve a salir. Si el navegador no vuelve a VS Code, usa «Iniciar sesión con código» y pega el código que te enseña la página.

Qué apruebas. Antes de cambiar un fichero, Naos abre el cambio en un diff: a la izquierda el fichero como está, a la derecha cómo quedará. Pulsa Save para aplicarlo o Reject para que no se haga (Naos le dice al modelo que no lo hizo). Antes de ejecutar un comando te enseña el comando entero: Run Command lo ejecuta y Reject no. Para abrir una dirección web, Approve o Reject.

Si el fichero que Naos quiere cambiar está abierto con cambios sin guardar, no lo toca y te avisa: «Guarda hola.py antes de que Naos lo edite.». Guárdalo (o descarta tus cambios) y pídeselo otra vez.

Lecturas. Naos lee sin preguntar los ficheros de las carpetas que tienes abiertas en VS Code. Para leer cualquier fichero fuera de ellas te pregunta antes y te enseña la ruta completa: con Reject su contenido no sale de tu equipo. Si abres VS Code sin carpeta, pregunta por cada lectura.

Tu uso. La barra de estado, abajo, dice tu plan y cuánto llevas de la ventana de 5 horas (por ejemplo «Naos: Pro · 12 %»). Al pulsarla tienes «Ver mi uso en Naos», que abre la página Tu uso con cada tope de tu plan en porcentaje y cuándo se renueva, «Ayuda», que abre esta guía, y «Cerrar sesión».

Si llegas a un tope. Tu acceso queda en pausa hasta que se renueva: la barra dice «Naos: pausado hasta» y la hora, el chat te lo explica en lugar de responder, y en Tu uso ves qué tope fue y cuándo vuelves. No tienes que hacer nada: vuelve solo.

Cerrar sesión. En el menú de la barra de estado, «Cerrar sesión». La clave de ese equipo se desactiva y se borra de tu disco, y el equipo desaparece de Equipos conectados en tu cuenta. Si vas a desinstalar la extensión, cierra sesión antes; si ya la desinstalaste, desconecta el equipo desde Equipos conectados, en tu cuenta.

Tus conversaciones. Se guardan solo en tu equipo, en ~/.naos/vscode/data (o en $NAOS_HOME/vscode/data), nunca en el servidor de Naos. Para borrarlas, abre History en la vista de Naos y bórralas de una en una o todas a la vez.