docs: add OpenChamber feature docs and translations (#1400)

* docs: add OpenChamber feature docs and translations

Add 30 new docs pages covering OpenChamber-specific workflows and setup:
OpenCode server, providers/models/agents, MCP, skills, commands & snippets,
usage, projects, context, notes/todos/plans, scheduled tasks, project actions,
preview, worktrees, multi-run, git & GitHub, magic prompts, git identities,
mobile/PWA, security, notifications, voice, project icons, remote instances,
desktop browser, updates, and three troubleshooting pages.

Rebuild sidebar into eight task-oriented sections and translate every new
page into all six supported locales (uk, zh-cn, es, pt-br, ko, pl).

* docs: surface new sections on homepage and cross-link tunnels

Add an Explore block to the docs homepage (all seven locales) linking to
the new section anchors, and cross-link the Tunnels page to Security and
PWA & Mobile.

packages/docs/content/docs/commands-snippets.mdx

@@ -0,0 +1,39 @@
+---
+title: Commands & Snippets
+description: Make reusable slash commands and text snippets for chat.
+---
+
+# Commands & Snippets
+
+Commands and snippets both save you from retyping the same thing. Commands are whole prompts you trigger with `/`; snippets are bits of text you drop into a message with `#`.
+
+## Commands
+
+A command is a saved prompt you run with a slash, like `/review`. Manage them at **Settings → Commands**.
+
+1. Open **Settings → Commands** and create a command.
+2. Give it a name, a description, and the prompt text it should send.
+3. Optionally pin it to a specific agent or model.
+4. Choose personal or project scope.
+
+In chat, type `/` as the **first** character of the message to bring up commands, then pick one. Your text can use placeholders:
+
+- `$ARGUMENTS` — whatever you type after the command
+- `@filename` — drops in the contents of a file
+- `` !`command` `` — drops in the output of a shell command
+
+The built-in `init` and `review` commands can be reset but not deleted.
+
+## Snippets
+
+A snippet is reusable text you reference inline with a hashtag, like `#signoff`. Manage them at **Settings → Snippets**.
+
+1. Open **Settings → Snippets** and create a snippet.
+2. Give it a name and the text it stands for. Add aliases if you want more than one trigger.
+3. Choose personal or project scope.
+
+In chat, type `#` and pick a snippet. OpenChamber swaps in the full text before sending.
+
+## Related
+
+- [Skills](/skills/) — load larger instruction sets on demand

packages/docs/content/docs/context.mdx

@@ -0,0 +1,38 @@
+---
+title: Context
+description: See how much of the model's memory a session is using.
+---
+
+# Context
+
+Every model can only hold so much of a conversation at once — its context. OpenChamber shows how full that is, so you can tell when a session is getting close to the limit and a reply might start dropping older detail.
+
+## The quick indicator
+
+While you chat, a small gauge shows the percentage of context used. It changes color as you fill up:
+
+- green — plenty of room
+- yellow — getting full (around three-quarters)
+- red — nearly full
+
+Hover it (or tap it on mobile) to see exact token counts.
+
+## The full context panel
+
+Open the **Context** tab in the right sidebar for a fuller picture of the current session:
+
+- the model in use and when the session started
+- total tokens against the model's limit
+- message and cost totals
+- a breakdown of the last reply's tokens
+- a rough split of what's taking up context (your messages, the agent's, tool output)
+
+The breakdown is an estimate, not an exact count — use it to spot what's filling the window, not for billing.
+
+## What to do when it's full
+
+Start a fresh session for a new task instead of letting one session grow forever. A shorter context is faster and keeps the model focused.
+
+## Related
+
+- [Projects](/projects/) — sessions are grouped per project

packages/docs/content/docs/desktop-browser.mdx

@@ -0,0 +1,22 @@
+---
+title: Desktop Browser
+description: Browse any page inside the desktop app, with inspect and console capture.
+---
+
+# Desktop Browser
+
+The desktop app has a built-in browser so you can open any page right next to your chat, point at elements to ask about them, and capture the page's console. Open it from the globe button in the app header.
+
+> The desktop browser is a **desktop-only** feature. On the web, the [preview](/preview/) panel offers the same inspect-and-console tools for your local dev server.
+
+## Inspect and annotate
+
+Turn on **inspect** and click any element on the page. OpenChamber captures a note about it — what it is, its styles, where it sits, and a screenshot — and attaches it to your chat message. It's the quickest way to tell the agent "this element, right here."
+
+## Console capture
+
+The browser collects the page's console output — errors, warnings, and logs — so you can filter and read it without opening developer tools.
+
+## Related
+
+- [Preview & Dev Servers](/preview/) — the same tools for your local dev server

packages/docs/content/docs/es/commands-snippets.mdx

@@ -0,0 +1,39 @@
+---
+title: Comandos y fragmentos
+description: Crea comandos de barra y fragmentos de texto reutilizables para el chat.
+---
+
+# Comandos y fragmentos
+
+Los comandos y los fragmentos te ahorran reescribir lo mismo una y otra vez. Los comandos son prompts completos que activas con `/`; los fragmentos son trozos de texto que insertas en un mensaje con `#`.
+
+## Comandos
+
+Un comando es un prompt guardado que ejecutas con una barra, como `/review`. Gestiónalos en **Settings → Commands**.
+
+1. Abre **Settings → Commands** y crea un comando.
+2. Dale un nombre, una descripción y el texto del prompt que debe enviar.
+3. Opcionalmente, fíjalo a un agente o modelo concreto.
+4. Elige el ámbito personal o de proyecto.
+
+En el chat, escribe `/` como **primer** carácter del mensaje para abrir los comandos y elige uno. Tu texto puede usar marcadores de posición:
+
+- `$ARGUMENTS` — lo que escribas después del comando
+- `@filename` — inserta el contenido de un archivo
+- `` !`command` `` — inserta la salida de un comando de shell
+
+Los comandos integrados `init` y `review` se pueden restablecer, pero no eliminar.
+
+## Fragmentos
+
+Un fragmento es texto reutilizable que referencias en línea con una almohadilla, como `#signoff`. Gestiónalos en **Settings → Snippets**.
+
+1. Abre **Settings → Snippets** y crea un fragmento.
+2. Dale un nombre y el texto que representa. Añade alias si quieres más de un disparador.
+3. Elige el ámbito personal o de proyecto.
+
+En el chat, escribe `#` y elige un fragmento. OpenChamber inserta el texto completo antes de enviar.
+
+## Relacionado
+
+- [Skills](/es/skills/) — carga conjuntos de instrucciones más grandes cuando los necesitas

packages/docs/content/docs/es/context.mdx

@@ -0,0 +1,38 @@
+---
+title: Contexto
+description: Mira cuánta memoria del modelo está usando una sesión.
+---
+
+# Contexto
+
+Cada modelo solo puede retener una parte de una conversación a la vez: su contexto. OpenChamber muestra qué tan lleno está, para que sepas cuándo una sesión se acerca al límite y una respuesta podría empezar a descartar detalles antiguos.
+
+## El indicador rápido
+
+Mientras chateas, un pequeño medidor muestra el porcentaje de contexto usado. Cambia de color a medida que se llena:
+
+- verde — espacio de sobra
+- amarillo — llenándose (alrededor de tres cuartos)
+- rojo — casi lleno
+
+Pasa el cursor por encima (o tócalo en el móvil) para ver el recuento exacto de tokens.
+
+## El panel de contexto completo
+
+Abre la pestaña **Context** en la barra lateral derecha para una imagen más completa de la sesión actual:
+
+- el modelo en uso y cuándo empezó la sesión
+- el total de tokens frente al límite del modelo
+- los totales de mensajes y coste
+- un desglose de los tokens de la última respuesta
+- una distribución aproximada de qué ocupa el contexto (tus mensajes, los del agente, la salida de herramientas)
+
+El desglose es una estimación, no un recuento exacto: úsalo para detectar qué está llenando la ventana, no para la facturación.
+
+## Qué hacer cuando está lleno
+
+Inicia una sesión nueva para una tarea nueva en lugar de dejar que una sola sesión crezca indefinidamente. Un contexto más corto es más rápido y mantiene al modelo enfocado.
+
+## Relacionado
+
+- [Proyectos](/es/projects/) — las sesiones se agrupan por proyecto

packages/docs/content/docs/es/desktop-browser.mdx

@@ -0,0 +1,22 @@
+---
+title: Navegador de escritorio
+description: Navega cualquier página dentro de la app de escritorio, con inspección y captura de consola.
+---
+
+# Navegador de escritorio
+
+La app de escritorio tiene un navegador integrado para que abras cualquier página justo al lado de tu chat, señales elementos para preguntar sobre ellos y captures la consola de la página. Ábrelo desde el botón del globo en el encabezado de la app.
+
+> El navegador de escritorio es una función **solo de escritorio**. En la web, el panel de [vista previa](/es/preview/) ofrece las mismas herramientas de inspección y consola para tu servidor de desarrollo local.
+
+## Inspecciona y anota
+
+Activa **inspect** y haz clic en cualquier elemento de la página. OpenChamber captura una nota sobre él —qué es, sus estilos, dónde se sitúa y una captura de pantalla— y la adjunta a tu mensaje del chat. Es la forma más rápida de decirle al agente "este elemento, justo aquí".
+
+## Captura de consola
+
+El navegador recopila la salida de la consola de la página —errores, advertencias y registros— para que puedas filtrarla y leerla sin abrir las herramientas de desarrollo.
+
+## Relacionado
+
+- [Vista previa y servidores de desarrollo](/es/preview/) — las mismas herramientas para tu servidor de desarrollo local

packages/docs/content/docs/es/git-identities.mdx

@@ -0,0 +1,30 @@
+---
+title: Identidades de Git
+description: Haz commit con el nombre y correo correctos para cada repositorio.
+---
+
+# Identidades de Git
+
+Una identidad de git es el nombre y el correo con los que se firman tus commits. Si trabajas en repos personales y de trabajo, puedes guardar identidades y aplicar la correcta en cada repositorio, en lugar de depender de un único ajuste global. Gestiónalas en **Settings → Git**.
+
+## Añade una identidad
+
+1. Abre **Settings → Git** y elige **New**.
+2. Introduce el **nombre** y el **correo** con los que harás commit.
+3. Elige cómo se autentica con el remoto:
+   - **SSH** — apúntala a una clave SSH
+   - **token** — usa una credencial guardada para un host
+4. Opcionalmente, dale un color y un icono para reconocerla fácilmente.
+
+La identidad global de tu sistema también se muestra, como solo lectura.
+
+## Aplica una identidad a un repo
+
+Al aplicar una identidad se escribe en la configuración **local** de git de ese repositorio: solo afecta a ese repo, no a tu ajuste global. Las identidades SSH también configuran el comando SSH para usar tu clave; las identidades de token configuran el almacenamiento de credenciales para el host.
+
+Puedes importar identidades que OpenChamber descubre a partir de tus credenciales de git existentes y guardarlas como identidades de token.
+
+## Relacionado
+
+- [Flujos de trabajo de Git y GitHub](/es/git/) — haz commit con la identidad que configures
+- [Issues y PRs de GitHub](/es/github/) — conecta una cuenta de GitHub para los PRs

packages/docs/content/docs/es/git.mdx

@@ -0,0 +1,41 @@
+---
+title: Flujos de trabajo de Git y GitHub
+description: Prepara, confirma y gestiona ramas sin salir de OpenChamber.
+---
+
+# Flujos de trabajo de Git y GitHub
+
+OpenChamber tiene una vista de git integrada para que revises cambios, hagas commit y gestiones ramas sin cambiar a una terminal. Ábrela desde la pestaña **Git** en la barra lateral derecha.
+
+## Revisar y confirmar
+
+La vista de git divide tus cambios en **staged** y **unstaged**:
+
+- haz clic en el **+** de un archivo para prepararlo, o en **−** para quitarlo del área de preparación
+- prepara o quita todo un grupo de una vez
+- haz clic en un archivo para ver su diff
+
+Luego escribe un mensaje de commit y confirma. Puedes hacer que OpenChamber **genere un mensaje de commit** a partir de tus cambios preparados: usa el modelo de la sesión actual, así que necesitas una sesión abierta.
+
+## Ramas e historial
+
+La vista de git también cubre el resto del día a día de git:
+
+- crear, cambiar, renombrar y eliminar ramas
+- push, pull y fetch
+- explorar el historial y los diffs por commit
+- guardar (stash) y restaurar cambios
+
+## Pull requests
+
+Conecta GitHub (consulta [Issues y PRs de GitHub](/es/github/)) y la pestaña **PR** te permite abrir un pull request, actualizarlo, marcarlo como listo o fusionarlo, y generar su título y descripción de la misma forma que los mensajes de commit.
+
+## Resolver conflictos
+
+Si una fusión, rebase o integración encuentra un conflicto, OpenChamber muestra qué está atascado y te deja resolverlo, incluso entregándoselo al agente.
+
+## Relacionado
+
+- [Issues y PRs de GitHub](/es/github/) — conecta GitHub y empieza a trabajar desde issues
+- [Sesiones de worktree](/es/worktrees/) — aísla una rama en su propia carpeta
+- [Identidades de Git](/es/git-identities/) — haz commit como la persona correcta en cada repo

packages/docs/content/docs/es/github.mdx

@@ -0,0 +1,34 @@
+---
+title: Issues y PRs de GitHub
+description: Conecta GitHub e inicia sesiones desde issues y pull requests.
+---
+
+# Issues y PRs de GitHub
+
+Conecta tu cuenta de GitHub y OpenChamber podrá traer issues y pull requests, iniciar una sesión directamente desde uno, y abrir o actualizar PRs por ti.
+
+## Conecta GitHub
+
+1. Abre **Settings → Git**.
+2. En GitHub, elige **Connect**. OpenChamber muestra un enlace y un código corto.
+3. Abre el enlace, introduce el código y aprueba.
+
+Cuando esté conectado, tu cuenta aparece en la sección de GitHub. Puedes conectar más de una cuenta y cambiar entre ellas, o desconectar en cualquier momento.
+
+## Empieza a trabajar desde una issue o PR
+
+Cuando creas una [sesión de worktree](/es/worktrees/) con GitHub conectado, puedes elegir **Start from GitHub issue/PR**:
+
+- elige una **issue** y OpenChamber nombra la rama según ella y abre la sesión con la issue y sus comentarios como primer mensaje
+- elige un **pull request** y hace checkout de la rama del PR; puedes incluir el diff del PR para que el agente tenga el cambio completo
+
+Esto te deja directamente en una sesión con el contexto ya cargado.
+
+## Abre y gestiona pull requests
+
+Desde la pestaña **PR** en la [vista de git](/es/git/), puedes crear un pull request, actualizarlo, marcar un borrador como listo o fusionarlo. OpenChamber puede generar el título y la descripción del PR a partir de tus cambios.
+
+## Relacionado
+
+- [Flujos de trabajo de Git y GitHub](/es/git/) — haz commit y gestiona ramas
+- [Sesiones de worktree](/es/worktrees/) — donde empiezan las sesiones de issue y PR

packages/docs/content/docs/es/index.mdx

@@ -20,6 +20,13 @@ Usa esta documentación para:
 - [Túneles](/es/tunnels/)
 - [Resolución de problemas](/es/troubleshooting/)
 
+## Explora
+
+- [Proyectos](/es/projects/) y [Sesiones de worktree](/es/worktrees/) — organiza y aísla tu trabajo
+- [Proveedores, modelos y agentes](/es/providers/) — conecta OpenCode y elige un modelo
+- [Flujos de trabajo de Git y GitHub](/es/git/) — haz commits, revisa y abre PRs
+- [Seguridad](/es/security/) y [Túneles](/es/tunnels/) — protege tu instancia y accede a ella
+
 ## Para qué sirve OpenChamber
 
 OpenChamber está pensado para las partes de la programación con IA que se benefician de un centro de control: ramificar sesiones, revisar diffs, gestionar terminales, observar el progreso de las herramientas, ejecutar acciones de proyecto y mantener todo el panel a la vista mientras el agente trabaja.

packages/docs/content/docs/es/magic-prompts.mdx

@@ -0,0 +1,26 @@
+---
+title: Magic Prompts
+description: Personaliza los prompts integrados detrás de los flujos automatizados de OpenChamber.
+---
+
+# Magic Prompts
+
+OpenChamber usa prompts integrados en segundo plano cada vez que hace algo automáticamente: escribir un mensaje de commit, redactar un PR, revisar una issue, resolver un conflicto, resumir una sesión. Magic Prompts es donde lees y reescribes esos prompts. Ábrelo en **Settings → Magic Prompts**.
+
+No necesitas esta página para el uso normal. Recurre a ella cuando quieras que un flujo se comporte de otra manera; por ejemplo, mensajes de commit con un estilo particular.
+
+## Edita un prompt
+
+1. Abre **Settings → Magic Prompts**.
+2. Elige un prompt de los grupos en la barra lateral: Git, GitHub, Planning y Session.
+3. Edita el texto y guarda.
+
+Algunos prompts tienen una parte visible (el mensaje que verías) y una parte de instrucciones (guía oculta para el agente). Los prompts pueden incluir `{{placeholders}}` que OpenChamber rellena, como el diff o el título de la issue; mantenlos en su sitio.
+
+## Restablecer
+
+¿Cambiaste de opinión? Cada prompt tiene **reset to default**, y hay un **reset all** si quieres empezar de cero en todas partes.
+
+## Relacionado
+
+- [Flujos de trabajo de Git y GitHub](/es/git/) — muchos de estos prompts impulsan los flujos de git

packages/docs/content/docs/es/mcp.mdx

@@ -0,0 +1,30 @@
+---
+title: Servidores MCP
+description: Añade servidores MCP para dar herramientas extra a los agentes.
+---
+
+# Servidores MCP
+
+Un servidor MCP da a tus agentes herramientas adicionales: cosas como buscar en una base de datos, llamar a una API o leer un servicio que usas. Añádelos en **Settings → MCP**.
+
+## Añade un servidor
+
+1. Abre **Settings → MCP**.
+2. Añade un servidor y elige su tipo:
+   - **local** — OpenChamber ejecuta un comando en tu máquina. Le das el comando que debe ejecutar y, si hace falta, variables de entorno.
+   - **remote** — OpenChamber se conecta a una URL que aloja otra persona. Le das la URL y cualquier encabezado que necesite (por ejemplo, un token de autenticación).
+3. Guarda. El servidor está activo de forma predeterminada; puedes desactivarlo sin eliminarlo.
+
+## Dónde se aplica
+
+Elige el ámbito al añadir un servidor:
+
+- **personal** — disponible en todos los proyectos
+- **proyecto** — disponible solo en el proyecto actual, y guardado junto con los demás ajustes del proyecto
+
+Los nombres de los servidores usan letras minúsculas, números, guiones y guiones bajos.
+
+## Relacionado
+
+- [Proveedores, modelos y agentes](/es/providers/) — conecta primero un modelo
+- [Skills](/es/skills/) — otra forma de ampliar lo que pueden hacer los agentes

packages/docs/content/docs/es/mobile.mdx

@@ -0,0 +1,31 @@
+---
+title: PWA y acceso móvil
+description: Instala OpenChamber como una app y úsalo desde tu teléfono.
+---
+
+# PWA y acceso móvil
+
+La app web de OpenChamber se instala como una app de teléfono (una PWA), así que puedes tenerla en tu pantalla de inicio y usarla a pantalla completa. Combínala con un [túnel](/es/tunnels/) y podrás echar un vistazo a una sesión desde cualquier lugar.
+
+## Instálala
+
+OpenChamber usa la instalación integrada de tu navegador, así que no hay una descarga aparte:
+
+- **navegador de escritorio** — usa la opción **Install** en la barra de direcciones
+- **iPhone/iPad (Safari)** — Compartir → **Añadir a pantalla de inicio**
+- **Android (Chrome)** — menú → **Instalar app** / **Añadir a pantalla de inicio**
+
+Una vez instalada, se abre en su propia ventana sin los elementos del navegador.
+
+## Accede desde tu teléfono
+
+Para abrir OpenChamber en tu teléfono cuando el servidor se ejecuta en tu computadora, inicia un [túnel](/es/tunnels/) y abre el enlace (o escanea el código QR) en el teléfono. Usa una [contraseña de UI](/es/security/) fuerte siempre que lo hagas.
+
+## Ajustes móviles
+
+En **Settings → OpenChamber**, unas pocas opciones ajustan la experiencia móvil e instalada: el nombre con el que se instala la app, la orientación de la pantalla y cómo se comporta el teclado en pantalla.
+
+## Relacionado
+
+- [Túneles](/es/tunnels/) — accede a tu instancia desde otra red
+- [Seguridad](/es/security/) — protege la UI antes de exponerla

packages/docs/content/docs/es/multi-run.mdx

@@ -0,0 +1,34 @@
+---
+title: Multi-run
+description: Ejecuta el mismo prompt en varios modelos o sesiones a la vez.
+---
+
+# Multi-run
+
+Multi-run lanza varias sesiones desde un solo formulario, útil para probar la misma tarea con distintos modelos y comparar los resultados. Ábrelo desde el botón en la parte superior de la barra lateral de sesiones.
+
+## Inicia un multi-run
+
+1. Abre el lanzador de multi-run.
+2. Elige el proyecto y nombra el grupo de ejecución.
+3. Escribe el prompt y elige los modelos con los que ejecutarlo (hasta cinco por grupo).
+4. Elige si quieres **aislar las ejecuciones**.
+5. Lanza.
+
+Cada modelo recibe su propia sesión, y todas empiezan con tu prompt.
+
+## Ejecuciones aisladas
+
+Activa **isolate runs** para dar a cada ejecución su propio [worktree](/es/worktrees/) y rama, de modo que nunca toquen los mismos archivos. Esto requiere un repositorio de git: se desactiva automáticamente en carpetas que no lo son. Elige la rama desde la que parten las ejecuciones.
+
+Con el aislamiento desactivado, cada ejecución es una sesión normal en la carpeta del proyecto.
+
+## Comparar resultados
+
+Cada ejecución es una sesión normal que puedes abrir, leer y conservar o descartar. Si iniciaste ejecuciones para comparar enfoques, revísalas en paralelo y lleva adelante el mejor.
+
+Si una sola ejecución no logra iniciarse, las demás se lanzan igualmente: simplemente verás menos sesiones de las que pediste.
+
+## Relacionado
+
+- [Sesiones de worktree](/es/worktrees/) — cómo funciona el aislamiento por dentro

packages/docs/content/docs/es/notes-todos-plans.mdx

@@ -0,0 +1,37 @@
+---
+title: Notas, tareas y planes de proyecto
+description: Mantén notas, una lista de tareas y planes guardados para cada proyecto.
+---
+
+# Notas, tareas y planes de proyecto
+
+Cada proyecto tiene su propio espacio de trabajo para notas, una lista de tareas y planes guardados. Pertenecen al proyecto, no a ninguna sesión concreta, así que permanecen mientras te mueves entre sesiones. Los encuentras en la pestaña **Context** de la barra lateral derecha (una pestaña dedicada en el móvil).
+
+## Notas
+
+Un cuadro de notas de formato libre para cualquier cosa que quieras recordar sobre el proyecto. Se guarda solo a medida que escribes.
+
+## Tareas
+
+Una lista de verificación sencilla. Añade elementos, márcalos como completados, reordénalos arrastrando y elimina los terminados.
+
+Cada tarea tiene un menú **send** para que se la entregues al agente:
+
+- enviarla a la sesión actual
+- iniciar una sesión nueva con ella
+- iniciar una nueva [sesión de worktree](/es/worktrees/) con ella (solo cuando el proyecto es un repositorio de git)
+
+## Planes
+
+Un lugar para guardar planes más largos como archivos. Puedes:
+
+- importar un plan desde un archivo Markdown o de texto
+- abrir un plan para leerlo en el panel lateral
+- eliminar los planes que ya no necesites
+
+Deberías volver a la pestaña Context con tu nota guardada, tu tarea marcada o tu plan listado: así sabes que funcionó.
+
+## Relacionado
+
+- [Sesiones de worktree](/es/worktrees/) — ejecuta una tarea en su propia rama
+- [Proyectos](/es/projects/) — estos pertenecen al proyecto activo

packages/docs/content/docs/es/notifications.mdx

@@ -0,0 +1,34 @@
+---
+title: Notificaciones
+description: Recibe avisos cuando una sesión te necesita o termina.
+---
+
+# Notificaciones
+
+Las notificaciones te avisan cuando algo necesita tu atención para que no tengas que vigilar la pantalla: una sesión terminó, encontró un error, hizo una pregunta o necesita permiso para hacer algo. Configúralas en **Settings → OpenChamber → Notifications**.
+
+## Actívalas
+
+1. Abre **Settings → OpenChamber → Notifications**.
+2. Permite las notificaciones cuando tu navegador o sistema lo pida.
+3. Elige sobre qué quieres recibir avisos:
+   - una sesión **termina**
+   - una sesión encuentra un **error**
+   - una sesión **hace una pregunta**
+   - una sesión necesita **permiso**
+   - se completan **subtareas**
+
+## Cómo te llegan
+
+- en el **escritorio**, recibes notificaciones nativas del sistema
+- en un **navegador o app instalada**, recibes notificaciones web push, así que llegan incluso cuando la pestaña está en segundo plano
+
+Las sesiones configuradas para aceptar automáticamente no te molestarán con notificaciones de permiso.
+
+## Personaliza el texto
+
+Cada tipo de notificación tiene una plantilla de título y mensaje que puedes editar, usando campos como el nombre del agente y el modelo. También hay un límite de cuánto del último mensaje se incluye, para que las notificaciones queden cortas.
+
+## Relacionado
+
+- [Modo de voz](/es/voice/) — escucha las respuestas leídas en voz alta

packages/docs/content/docs/es/opencode-server.mdx

@@ -0,0 +1,54 @@
+---
+title: OpenCode Server
+description: Conecta OpenChamber a un servidor de OpenCode local o remoto.
+---
+
+# OpenCode Server
+
+OpenChamber se ejecuta sobre un servidor de OpenCode. De forma predeterminada inicia uno por ti, así que no tienes que hacer nada. Solo necesitas esta página si quieres apuntar OpenChamber a un servidor que ya ejecutas, o gestionar el que él inicia.
+
+## Cómo encuentra OpenChamber un servidor
+
+Cuando OpenChamber arranca, busca un servidor en este orden:
+
+1. reutilizar un servidor que ya inició
+2. conectarse a uno externo si se lo indicaste (ver más abajo)
+3. detectar automáticamente un servidor en el puerto predeterminado (`4096`)
+4. de lo contrario, iniciar y gestionar el suyo propio
+
+Si no hay nada configurado, el paso 4 ocurre automáticamente y ya tienes todo en marcha.
+
+## Conéctate a un servidor que ya ejecutas
+
+Define esto antes de iniciar OpenChamber:
+
+```bash
+OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber
+```
+
+- `OPENCODE_HOST` — la dirección completa de tu servidor de OpenCode, incluido el puerto (un valor como `http://localhost:4096`). No debe tener una ruta al final.
+- `OPENCODE_SKIP_START=true` — le indica a OpenChamber que no inicie su propio servidor.
+
+Si solo necesitas cambiar el puerto, define `OPENCODE_PORT` en lugar de `OPENCODE_HOST`.
+
+Si a `OPENCODE_HOST` le falta el puerto o tiene una ruta, OpenChamber lo ignora y recurre a iniciar su propio servidor. Observa los registros de arranque por si aparece una advertencia `[config]` cuando una conexión que esperabas no ocurrió.
+
+## Gestiona el servidor desde la CLI
+
+```bash
+openchamber status
+openchamber logs
+openchamber restart
+openchamber stop
+```
+
+`openchamber` por sí solo inicia el servidor en segundo plano. Añade `--foreground` para mantenerlo asociado a tu terminal.
+
+## "OpenCode is restarting"
+
+Mientras el servidor se inicia o reinicia, OpenChamber muestra un estado "OpenCode is restarting" y pausa las solicitudes hasta que esté listo. Esto es normal justo después de iniciar o reiniciar. Si nunca desaparece, consulta [Conexión de OpenCode](/es/troubleshooting/opencode-connection/).
+
+## Relacionado
+
+- [Proveedores, modelos y agentes](/es/providers/) — configura con qué se comunica el servidor
+- [Conexión de OpenCode](/es/troubleshooting/opencode-connection/) — si no se conecta

packages/docs/content/docs/es/preview.mdx

@@ -0,0 +1,32 @@
+---
+title: Vista previa y servidores de desarrollo
+description: Abre un servidor de desarrollo en marcha dentro de OpenChamber.
+---
+
+# Vista previa y servidores de desarrollo
+
+Cuando inicias un servidor de desarrollo, OpenChamber puede abrirlo dentro de la propia app en lugar de en una pestaña de navegador aparte, para que veas tu sitio junto al chat, captures su consola y señales elementos para preguntar sobre ellos.
+
+## Abre una vista previa
+
+OpenChamber observa la salida de la terminal en busca de una dirección local (la línea `Local:` que imprimen herramientas como Vite, Next.js o Astro). Cuando detecta una:
+
+- en la terminal aparece un botón **Open preview**
+- una [acción de proyecto](/es/project-actions/) con la apertura automática activada la abre por ti
+- un enlace local en un mensaje del chat también puede abrirla
+
+El sitio se carga en el panel lateral. Solo se pueden previsualizar direcciones locales (en tu propia máquina).
+
+## Consola e inspección
+
+En el panel de vista previa puedes:
+
+- ver la **consola** de la página —errores, advertencias y registros— filtrada como prefieras
+- activar **inspect**, hacer clic en cualquier elemento y enviar una nota sobre él —selector, estilos, posición y una captura de pantalla— directamente al chat
+
+Esta es la forma más rápida de decirle al agente "este botón, aquí" sin describirlo.
+
+## Relacionado
+
+- [Acciones de proyecto](/es/project-actions/) — abre automáticamente un servidor al iniciarlo
+- [Navegador de escritorio](/es/desktop-browser/) — las mismas herramientas para cualquier página, en el escritorio

packages/docs/content/docs/es/project-actions.mdx

@@ -0,0 +1,28 @@
+---
+title: Acciones de proyecto
+description: Guarda comandos que ejecutas a menudo y lánzalos con un solo clic.
+---
+
+# Acciones de proyecto
+
+Una acción de proyecto es un comando de shell que guardas una vez y ejecutas con un clic: tu servidor de desarrollo, una compilación, una ejecución de pruebas. Cada proyecto mantiene su propia lista. Configúralas en **Settings → Projects → Project Actions**.
+
+## Añade una acción
+
+1. Abre **Settings → Projects** y busca la sección **Project Actions**.
+2. Añade una acción, dale un nombre, elige un icono e introduce el comando a ejecutar.
+3. Guarda.
+
+Puedes limitar una acción a ciertos sistemas operativos si un comando solo tiene sentido en uno.
+
+## Ejecuta una acción
+
+Las acciones viven en un menú del encabezado de la app. Haz clic en una y OpenChamber la ejecuta en una terminal dentro de la carpeta de tu proyecto, cambiándote a la vista de terminal para que veas la salida. Deténla desde el mismo menú.
+
+## Abre automáticamente un servidor de desarrollo
+
+Activa **auto-open URL** para una acción que inicia un servidor. OpenChamber observa la salida en busca de una dirección local y se ofrece a abrirla; consulta [Vista previa y servidores de desarrollo](/es/preview/). En el escritorio también puedes enrutarla a través de un reenvío de puertos SSH.
+
+## Relacionado
+
+- [Vista previa y servidores de desarrollo](/es/preview/) — abre un servidor de desarrollo en marcha dentro de OpenChamber

packages/docs/content/docs/es/project-icons.mdx

@@ -0,0 +1,20 @@
+---
+title: Iconos de proyecto
+description: Da a cada proyecto un icono reconocible.
+---
+
+# Iconos de proyecto
+
+Un icono de proyecto facilita distinguir tus proyectos de un vistazo. OpenChamber intenta encontrar uno por ti, y siempre puedes poner el tuyo. Gestiónalo en **Settings → Projects**.
+
+## Descubrimiento automático
+
+Cuando añades un proyecto, OpenChamber busca un archivo `favicon` dentro de él y lo usa como icono del proyecto. Si tu repo ya incluye un favicon, el icono normalmente aparece solo: no hay nada que hacer.
+
+## Pon el tuyo
+
+Abre **Settings → Projects** y sube una imagen (PNG, JPEG o SVG, hasta 5 MB). Una imagen personalizada tiene prioridad sobre la descubierta automáticamente. También puedes elegir un color en su lugar, o eliminar la imagen para volver al descubrimiento.
+
+## Relacionado
+
+- [Proyectos](/es/projects/) — nombra, da color y organiza tus proyectos

packages/docs/content/docs/es/projects.mdx

@@ -0,0 +1,34 @@
+---
+title: Proyectos
+description: Organiza tu trabajo en proyectos y cambia entre ellos.
+---
+
+# Proyectos
+
+Un proyecto es una carpeta de tu computadora que OpenChamber rastrea, normalmente un único código base. Cambiar de proyecto cambia la carpeta en la que trabaja el agente, junto con las sesiones y los ajustes de ese proyecto.
+
+## Añade un proyecto
+
+Puedes añadir un proyecto desde varios lugares:
+
+- la entrada **Add project** en la paleta de comandos
+- el botón **+** en la parte superior de la barra lateral de sesiones
+- el explorador de carpetas cuando eliges un directorio
+
+Apúntalo a una carpeta y OpenChamber la recuerda. El nombre viene de la carpeta; puedes cambiarlo más tarde.
+
+## Cambia de proyecto
+
+Elige un proyecto de la barra lateral para activarlo. Todo —sesiones, git, notas— sigue al proyecto que tengas abierto.
+
+## Haz reconocible un proyecto
+
+Abre **Settings → Projects** para darle a un proyecto un nombre, color o icono personalizado. OpenChamber intenta encontrar un icono automáticamente; consulta [Iconos de proyecto](/es/project-icons/).
+
+> En VS Code, OpenChamber siempre usa la carpeta que tienes abierta como único proyecto, así que no hay nada que añadir ni cambiar. La página de ajustes de proyectos está oculta allí.
+
+## Relacionado
+
+- [Notas, tareas y planes de proyecto](/es/notes-todos-plans/) — mantén notas de trabajo por proyecto
+- [Acciones de proyecto](/es/project-actions/) — guarda comandos que ejecutas a menudo
+- [Contexto](/es/context/) — mira cuánta memoria del modelo usa una sesión

packages/docs/content/docs/es/providers.mdx

@@ -0,0 +1,49 @@
+---
+title: Proveedores, modelos y agentes
+description: Conecta proveedores de IA, elige modelos y configura agentes.
+---
+
+# Proveedores, modelos y agentes
+
+Antes de que OpenChamber pueda hacer algo, necesita al menos un proveedor de IA conectado. Esta página cubre cómo conectar un proveedor, elegir un modelo y ajustar los agentes.
+
+## Conecta un proveedor
+
+1. Abre **Settings → Providers**.
+2. Abre el menú **Add provider** y elige un proveedor que aún no esté conectado.
+3. Inicia sesión de una de estas dos formas, según el proveedor:
+   - **Clave de API** — pega tu clave y guarda.
+   - **Inicio de sesión (flujo de dispositivo)** — OpenChamber muestra un enlace y un código corto. Abre el enlace, introduce el código y aprueba. OpenChamber termina de conectarse por su cuenta.
+
+Cuando un proveedor aparece como conectado, sus modelos quedan disponibles en el chat.
+
+Para desconectar, abre el proveedor y elige eliminar su inicio de sesión.
+
+## Elige un modelo
+
+Eliges el modelo en el lugar donde trabajas:
+
+- en el chat, usa el selector de modelo de la barra de mensajes para fijar el proveedor y el modelo de esa sesión
+- por agente, define un modelo predeterminado (más abajo)
+
+## Configura agentes
+
+Un agente es una configuración con nombre: un modelo, una personalidad y lo que se le permite hacer.
+
+1. Abre **Settings → Agents**.
+2. Elige un agente o crea uno nuevo.
+3. Edita cualquiera de estos campos:
+   - **description** — para qué sirve el agente
+   - **model** — su modelo predeterminado
+   - **temperature** — qué tan creativas son sus respuestas
+   - **prompt** — instrucciones permanentes que siempre sigue
+   - **tool rules** — qué herramientas puede usar
+
+## Dónde se guardan tus inicios de sesión
+
+Los inicios de sesión de los proveedores los guarda OpenCode, no OpenChamber, así que se comparten con la CLI de OpenCode. Si configuras el mismo proveedor en más de un lugar, gana el ajuste más específico: un ajuste por proyecto anula el personal.
+
+## Relacionado
+
+- [Servidores MCP](/es/mcp/) — añade herramientas extra para los agentes
+- [Uso y cuotas](/es/usage/) — controla cuánto has consumido

packages/docs/content/docs/es/remote-instances.mdx

@@ -0,0 +1,30 @@
+---
+title: Instancias remotas
+description: Conecta la app de escritorio a OpenChamber en otra máquina por SSH.
+---
+
+# Instancias remotas
+
+La app de escritorio puede conectarse a OpenChamber ejecutándose en otra máquina por SSH —un servidor de trabajo, una máquina en la nube, un homelab— y traer su UI a tu pantalla como si fuera local. Configúralo en **Settings → Remote Instances**.
+
+> Las instancias remotas son una función **solo de escritorio**. En la web o en VS Code, conéctate a un servidor remoto con las variables de entorno de [OpenCode Server](/es/opencode-server/) en su lugar.
+
+## Añade una instancia remota
+
+1. Abre **Settings → Remote Instances** y añade una.
+2. Dale el comando SSH que usarías normalmente para alcanzar la máquina, más un apodo.
+3. Elige cómo se ejecuta OpenChamber allí:
+   - **managed** — OpenChamber se instala y se inicia por sí mismo en la máquina remota
+   - **external** — conéctate a una que ya está en funcionamiento
+4. Conecta.
+
+OpenChamber recorre los pasos —comprobar la conexión, configurar el remoto, iniciar el servidor y reenviar el puerto— y muestra en qué punto está en cada etapa. Cuando llega a **ready**, la UI remota se carga localmente.
+
+## Credenciales
+
+Tú decides si guardar las contraseñas de SSH y de UI o introducirlas cada vez. Si la conexión se cae, OpenChamber informa qué paso falló para que puedas arreglarlo; consulta [Acceso remoto](/es/troubleshooting/remote-access/).
+
+## Relacionado
+
+- [OpenCode Server](/es/opencode-server/) — conéctate a un servidor remoto en la web o en VS Code
+- [Acceso remoto](/es/troubleshooting/remote-access/) — cuando una conexión no se completa

packages/docs/content/docs/es/scheduled-tasks.mdx

@@ -0,0 +1,33 @@
+---
+title: Tareas programadas
+description: Ejecuta un prompt automáticamente según una programación.
+---
+
+# Tareas programadas
+
+Una tarea programada ejecuta un prompt por ti según una programación; por ejemplo, un "resume los cambios de ayer" diario o una limpieza semanal. Cuando se ejecuta, OpenChamber inicia una sesión nueva y envía el prompt por su cuenta. Abre el programador desde el botón en la parte superior de la barra lateral de sesiones.
+
+## Crea una tarea
+
+1. Abre el diálogo de tareas programadas desde la barra lateral de sesiones.
+2. Añade una tarea y dale un nombre.
+3. Elige cuándo se ejecuta:
+   - **diaria** — a una o varias horas cada día
+   - **semanal** — en los días de la semana y horas elegidos
+   - **una vez** — una sola fecha y hora
+4. Define qué hace: el prompt a enviar, y el proveedor, modelo y agente a usar. El prompt puede ser un comando de barra, como `/review`.
+5. Guarda y asegúrate de que la tarea esté habilitada.
+
+Puedes ejecutar cualquier tarea de inmediato con **run now** para comprobar que hace lo que esperas.
+
+## Cómo se ve el éxito
+
+Después de una ejecución, la tarea muestra cuándo se ejecutó por última vez, si tuvo éxito y un enlace a la sesión que creó. Si una ejecución falla, el error también se muestra ahí.
+
+## Ten en cuenta
+
+Las tareas solo se disparan mientras el servidor de OpenChamber está en funcionamiento. Si lo cierras, las ejecuciones programadas se pausan hasta que vuelva a estar activo.
+
+## Relacionado
+
+- [Comandos y fragmentos](/es/commands-snippets/) — reutiliza un comando de barra como prompt

packages/docs/content/docs/es/security.mdx

@@ -0,0 +1,37 @@
+---
+title: Seguridad
+description: Protege la UI con una contraseña y passkeys antes de exponerla.
+---
+
+# Seguridad
+
+OpenChamber da acceso a tu máquina y a tu código, así que bloquéalo antes de que nadie más que tú pueda alcanzarlo. Esta página cubre la contraseña de UI, las passkeys y lo que debes saber antes de exponer OpenChamber a una red.
+
+## Define una contraseña de UI
+
+Inicia OpenChamber con una contraseña y la UI del navegador la pedirá:
+
+```bash
+openchamber --ui-password be-creative-here
+```
+
+También puedes definirla con la variable de entorno `OPENCHAMBER_UI_PASSWORD` en lugar de ponerla en la línea de comandos. Tras iniciar sesión, OpenChamber recuerda el dispositivo durante un tiempo para no pedírtela cada vez.
+
+Define siempre una contraseña si la instancia es accesible para alguien más, especialmente a través de un [túnel](/es/tunnels/) o de internet público.
+
+## Passkeys
+
+Una vez definida una contraseña, puedes añadir passkeys (Face ID, Touch ID, una llave de seguridad) para un inicio de sesión más rápido. Añádelas en **Settings → OpenChamber → Passkeys**.
+
+Las passkeys están vinculadas a la contraseña actual. Si cambias o eliminas la contraseña, las passkeys guardadas se borran y tendrás que añadirlas de nuevo.
+
+## Antes de exponerlo
+
+- De forma predeterminada, OpenChamber solo escucha en tu propia máquina (`127.0.0.1`). Hace falta un cambio deliberado para escuchar más ampliamente, y deberías definir una contraseña primero.
+- Prefiere un [túnel](/es/tunnels/) o una red privada (como una VPN) antes que abrir un puerto a internet.
+- Si pones OpenChamber detrás de tu propio servidor HTTPS, consulta [Proxy inverso](/es/reverse-proxy/).
+
+## Relacionado
+
+- [Túneles](/es/tunnels/) — la forma recomendada de acceder a una instancia de forma remota
+- [Proxy inverso](/es/reverse-proxy/) — ejecuta OpenChamber detrás de tu propio servidor

packages/docs/content/docs/es/skills-catalog.mdx

@@ -0,0 +1,27 @@
+---
+title: Catálogo de skills
+description: Explora e instala skills ya hechas.
+---
+
+# Catálogo de skills
+
+El catálogo de skills te permite instalar skills que otras personas han publicado en lugar de escribir las tuyas. Ábrelo en **Settings → Skills → Catalog**.
+
+Para escribir tus propias skills, consulta [Skills](/es/skills/).
+
+## Instala una skill
+
+1. Abre el catálogo.
+2. Explora las fuentes integradas —el repositorio de skills de Anthropic y el registro comunitario de ClawdHub— o busca.
+3. Elige una skill e instálala.
+4. Elige dónde instalarla: para todo lo que hagas, o solo en el proyecto actual.
+
+Si ya existe una skill con el mismo nombre, OpenChamber pregunta qué hacer: omitirla, sobrescribirla o decidir skill por skill.
+
+## Añade tu propia fuente
+
+Puedes añadir cualquier repositorio de Git como fuente usando su nombre `owner/repo` o una URL de Git completa. Los repositorios privados necesitan tener el acceso configurado en tu máquina (una clave SSH o credenciales guardadas); si una fuente no puede autenticarse, el catálogo lo indica en lugar de fallar en silencio.
+
+## Relacionado
+
+- [Skills](/es/skills/) — crea y gestiona las skills instaladas

packages/docs/content/docs/es/skills.mdx

@@ -0,0 +1,30 @@
+---
+title: Skills
+description: Crea instrucciones reutilizables que los agentes cargan cuando las necesitan.
+---
+
+# Skills
+
+Una skill es un conjunto reutilizable de instrucciones que un agente puede incorporar cuando es relevante; por ejemplo, "cómo escribimos los mensajes de commit" o "nuestras convenciones de API". Las gestionas en **Settings → Skills**.
+
+Para instalar skills ya hechas en lugar de escribir las tuyas, consulta [Catálogo de skills](/es/skills-catalog/).
+
+## Crea una skill
+
+1. Abre **Settings → Skills**.
+2. Crea una skill y dale un nombre y una descripción breve. La descripción es lo que el agente usa para decidir cuándo aplica la skill, así que hazla específica.
+3. Escribe las instrucciones. Añade archivos de apoyo si la skill los necesita.
+4. Elige dónde vive:
+   - **personal** — disponible en todos los proyectos
+   - **proyecto** — disponible solo en el proyecto actual
+
+## Usa una skill en el chat
+
+Escribe `/` en medio de un mensaje para abrir el selector de skills y elige una. El agente carga las instrucciones de esa skill para la respuesta.
+
+Una `/` al principio del mensaje abre los [comandos](/es/commands-snippets/) en su lugar.
+
+## Relacionado
+
+- [Catálogo de skills](/es/skills-catalog/) — instala skills que otros han publicado
+- [Comandos y fragmentos](/es/commands-snippets/) — otras formas de reutilizar texto en el chat

packages/docs/content/docs/es/troubleshooting/opencode-connection.mdx

@@ -0,0 +1,34 @@
+---
+title: Conexión de OpenCode
+description: Soluciona que OpenChamber no se conecte a su servidor de OpenCode.
+---
+
+# Conexión de OpenCode
+
+Si OpenChamber carga pero nunca pasa de "OpenCode is restarting", o el chat no responde, el servidor con el que se comunica no es accesible. Repasa estos pasos.
+
+## Se queda atascado en "OpenCode is restarting"
+
+- dale un momento justo después de iniciar: este estado es normal mientras el servidor arranca
+- comprueba si el servidor está vivo con `openchamber status`
+- reinícialo con `openchamber restart`
+- ve los detalles de arranque con `openchamber logs`
+
+## Te conectas a tu propio servidor
+
+Si configuraste OpenChamber para usar un servidor existente, revisa de nuevo la configuración de [OpenCode Server](/es/opencode-server/):
+
+- `OPENCODE_HOST` debe incluir el puerto, sin ruta; por ejemplo `http://localhost:4096`
+- define `OPENCODE_SKIP_START=true` para que OpenChamber no inicie también el suyo
+- si la dirección es inválida, OpenChamber la ignora e inicia su propio servidor en su lugar; busca una advertencia `[config]` en los registros
+
+## Sigue fallando
+
+- confirma que Node.js sea la versión `20` o más reciente
+- reinstala la última CLI
+- abre `http://localhost:3000` directamente antes de probar cualquier túnel o enlace remoto
+
+## Relacionado
+
+- [OpenCode Server](/es/opencode-server/) — cómo encuentra y gestiona OpenChamber el servidor
+- [Resolución de problemas](/es/troubleshooting/) — otros problemas comunes

packages/docs/content/docs/es/troubleshooting/remote-access.mdx

@@ -0,0 +1,38 @@
+---
+title: Acceso remoto
+description: Soluciona túneles, instancias remotas y el acceso a OpenChamber desde otro dispositivo.
+---
+
+# Acceso remoto
+
+Cuando no puedes alcanzar OpenChamber desde tu teléfono u otra máquina, la solución depende de cómo te estés conectando.
+
+## Comprueba lo básico primero
+
+- abre `http://localhost:3000` en la misma computadora primero; si eso falla, no es un problema remoto; consulta [Conexión de OpenCode](/es/troubleshooting/opencode-connection/)
+- confirma que el servidor está en funcionamiento con `openchamber status`
+
+## El enlace del túnel no funciona
+
+- ejecuta `openchamber tunnel status --all`
+- reinicia el túnel desde la misma instancia y puerto
+- regenera el enlace de conexión si el anterior ya se usó
+
+Consulta [Túneles](/es/tunnels/) para la configuración completa.
+
+## La instancia remota no se conecta (escritorio)
+
+Cuando una [instancia remota](/es/remote-instances/) se atasca, OpenChamber nombra el paso que falló:
+
+- **auth** — tu contraseña de SSH o de UI fue rechazada; vuelve a introducirla
+- **install / start** — OpenChamber no pudo configurar o iniciar el servidor en la máquina remota; comprueba los requisitos de esa máquina
+- **forwarding** — la conexión está activa pero el puerto no te llega; prueba un puerto local distinto
+
+## Detrás de tu propio servidor
+
+Si pones OpenChamber detrás de un proxy inverso y carga de forma extraña o no se conecta, consulta [Proxy inverso](/es/reverse-proxy/).
+
+## Relacionado
+
+- [Túneles](/es/tunnels/) · [Instancias remotas](/es/remote-instances/) · [Proxy inverso](/es/reverse-proxy/)
+- [Seguridad](/es/security/) — protege la UI antes de exponerla

packages/docs/content/docs/es/troubleshooting/worktrees-git.mdx

@@ -0,0 +1,35 @@
+---
+title: Worktrees y Git
+description: Soluciona problemas comunes de worktrees y git.
+---
+
+# Worktrees y Git
+
+Problemas que surgen con las [sesiones de worktree](/es/worktrees/) y la [vista de git](/es/git/), y cómo resolverlos.
+
+## Un worktree requiere atención
+
+OpenChamber señala un worktree cuando algo no encaja:
+
+- **carpeta ausente** — la carpeta del worktree se eliminó o se movió fuera de OpenChamber; elimina la sesión y crea un worktree nuevo
+- **rama desacoplada o sin nacer** — el worktree no está en una rama normal; haz checkout sobre una
+- **fusión, rebase o cherry-pick en curso** — una operación quedó a medias; termínala o abórtala desde la vista de git
+
+## No se puede crear un worktree
+
+- **la rama ya existe** — elige un nombre de rama distinto, o usa la opción de rama existente
+- **el nombre ya está en uso** — elige un nombre de worktree distinto
+
+## Falla la generación de commit o PR
+
+Generar un mensaje de commit o una descripción de PR se ejecuta en tu sesión activa, así que necesitas una sesión abierta con un modelo en funcionamiento seleccionado. Abre o elige una sesión e inténtalo de nuevo.
+
+## Problemas con SSH o rutas de Windows
+
+- asegúrate de que la clave SSH que usa el repo sea la que está configurada en tu [identidad de git](/es/git-identities/)
+- en Windows, git usa rutas al estilo Unix (como `/c/Users/...`); OpenChamber lo gestiona, pero las rutas de claves SSH personalizadas deben seguir el mismo formato
+
+## Relacionado
+
+- [Sesiones de worktree](/es/worktrees/) — cómo se crean y eliminan los worktrees
+- [Identidades de Git](/es/git-identities/) — define la clave e identidad correctas por repo

packages/docs/content/docs/es/tunnels.mdx

@@ -80,4 +80,6 @@ openchamber tunnel stop --port 3000
 
 ## Relacionado
 
+- [Seguridad](/es/security/) — protege la interfaz antes de exponerla
+- [PWA y acceso móvil](/es/mobile/) — accede a OpenChamber desde tu teléfono
 - [Resolución de problemas](/es/troubleshooting/) — si el enlace del túnel no funciona

packages/docs/content/docs/es/updates.mdx

@@ -0,0 +1,31 @@
+---
+title: Actualizaciones
+description: Mantén OpenChamber actualizado en escritorio, web y VS Code.
+---
+
+# Actualizaciones
+
+Cómo actualizas OpenChamber depende de cómo lo instalaste. En todos los casos puedes comprobar tu versión actual en **Settings → OpenChamber → About**.
+
+## App de escritorio
+
+La app de escritorio busca actualizaciones contra las releases de GitHub. Cuando hay una disponible, OpenChamber te avisa, la descarga cuando lo eliges y la instala en el siguiente reinicio. Siempre tienes el control: nada se instala sin tu aprobación.
+
+## Web / CLI
+
+Si instalaste la CLI, actualízala desde **About** con los botones de comprobar y actualizar, o desde la terminal:
+
+```bash
+openchamber update
+```
+
+OpenChamber detecta cómo se instaló (npm, pnpm, yarn o bun) y ejecuta la actualización correcta por ti.
+
+## El servidor de OpenCode
+
+OpenChamber y OpenCode se actualizan por separado. Cuando hay una nueva versión de OpenCode disponible, OpenChamber se ofrece a actualizarla y reinicia el servidor después. Consulta [OpenCode Server](/es/opencode-server/) para saber cómo se gestiona ese servidor.
+
+## Relacionado
+
+- [Instalación](/es/install/) — cómo se instala cada app en primer lugar
+- [OpenCode Server](/es/opencode-server/) — actualizar el servidor subyacente

packages/docs/content/docs/es/usage.mdx

@@ -0,0 +1,28 @@
+---
+title: Uso y cuotas
+description: Controla cuánto de tu plan de proveedor has consumido.
+---
+
+# Uso y cuotas
+
+La página de uso muestra cuánto del plan de cada proveedor has consumido, para que veas qué tan cerca estás de un límite. Ábrela en **Settings → Usage**.
+
+## Lo que ves
+
+Para cada proveedor conectado, OpenChamber muestra:
+
+- cuánto de la ventana actual has usado, como una barra
+- un desglose por modelo
+- un indicador de ritmo, para saber si vas camino de agotarlo
+
+Puedes elegir qué proveedores aparecen, y el mismo resumen está disponible desde un menú desplegable en el encabezado de la app.
+
+## Proveedores compatibles
+
+El uso funciona con los proveedores que publican una cuota, entre ellos Claude, Codex, GitHub Copilot, Google, OpenRouter, Kimi, NanoGPT, z.ai, Zhipu, MiniMax, Ollama Cloud y Wafer.
+
+Un proveedor solo muestra el uso una vez que has iniciado sesión en él en la página de [Proveedores](/es/providers/). Algunos proveedores necesitan un paso extra: por ejemplo, Ollama Cloud lee un archivo de sesión que configuras por separado. Si un proveedor no muestra datos, normalmente significa que falta esa credencial adicional.
+
+## Relacionado
+
+- [Proveedores, modelos y agentes](/es/providers/) — inicia sesión antes de que aparezca el uso

packages/docs/content/docs/es/voice.mdx

@@ -0,0 +1,36 @@
+---
+title: Modo de voz
+description: Habla con OpenChamber y escucha las respuestas leídas en voz alta.
+---
+
+# Modo de voz
+
+El modo de voz te permite dictar mensajes y que las respuestas se te lean en voz alta. Actívalo en **Settings → OpenChamber → Voice**.
+
+## Leer respuestas en voz alta (texto a voz)
+
+Elige cómo se pronuncian las respuestas:
+
+- **browser** — las voces integradas de tu navegador, sin configuración
+- **OpenAI** — las voces de OpenAI; pega tu clave de API y elige una voz
+- **compatible con OpenAI** — cualquier servicio que hable el formato de OpenAI; introduce su URL y, si la necesita, una clave de API
+- **macOS say** — el comando `say` integrado, en los Mac que lo tienen
+
+Una vez activado, obtienes un botón de reproducción en los mensajes para escucharlos en voz alta.
+
+## Dictar mensajes (voz a texto)
+
+Elige cómo se transcribe tu voz:
+
+- **browser** — el reconocimiento integrado de tu navegador, sin configuración
+- **server** — un servicio de transcripción compatible con OpenAI; introduce su URL y, si hace falta, una clave de API
+- **on-device** — un modelo de voz que se ejecuta en tu navegador y se descarga la primera vez que lo usas
+
+## Una nota para teléfonos
+
+Para leer respuestas en voz alta en un teléfono, las opciones de OpenAI o compatible con OpenAI son las más fiables: los navegadores móviles limitan las voces integradas.
+
+## Relacionado
+
+- [Notificaciones](/es/notifications/) — recibe un aviso en lugar de escuchar
+- [Proveedores, modelos y agentes](/es/providers/) — donde puede que ya tengas tu clave de OpenAI

packages/docs/content/docs/es/worktrees.mdx

@@ -0,0 +1,36 @@
+---
+title: Sesiones de worktree
+description: Da a una sesión su propia rama y carpeta para que el trabajo quede aislado.
+---
+
+# Sesiones de worktree
+
+Una sesión de worktree se ejecuta en su propia copia del repositorio, en su propia rama (un worktree de git). Eso evita que las sesiones paralelas se pisen los archivos: una puede refactorizar mientras otra corrige un error, sin estar cambiando de un lado a otro.
+
+## Crea una
+
+1. Abre el diálogo de nuevo worktree desde el botón en la parte superior de la barra lateral de sesiones.
+2. Elige un punto de partida:
+   - **nueva rama** — nombra la rama y elige desde qué rama partir
+   - **rama existente** — haz checkout de una rama que ya tengas
+3. Confirma la carpeta del worktree (OpenChamber sugiere una a partir del nombre de la rama).
+4. Créala.
+
+OpenChamber crea la rama, configura la carpeta e inicia una sesión en ella. También puedes arrancar una directamente desde una [tarea](/es/notes-todos-plans/) o desde una [issue o PR de GitHub](/es/github/).
+
+## Trae el trabajo de vuelta
+
+Cuando el trabajo esté listo, usa **Integrate** en la vista de Git para traer los commits del worktree a otra rama (como `main`). Si un cambio entra en conflicto, puedes entregarle el conflicto al agente para que lo resuelva.
+
+## Limpieza
+
+Eliminar o archivar la sesión puede quitar el worktree. Tú eliges si también eliminar la rama: local, y remota si la hay. No se elimina nada sin que lo pidas.
+
+## Si algo no encaja
+
+Un worktree puede requerir atención si su carpeta desapareció, su rama está en un estado desacoplado, o una fusión o rebase quedó a medias. OpenChamber lo señala para que lo arregles; consulta [Worktrees y Git](/es/troubleshooting/worktrees-git/).
+
+## Relacionado
+
+- [Multi-run](/es/multi-run/) — lanza muchas sesiones de worktree a la vez
+- [Flujos de trabajo de Git y GitHub](/es/git/) — haz commit e integra desde dentro de OpenChamber

packages/docs/content/docs/git-identities.mdx

@@ -0,0 +1,30 @@
+---
+title: Git Identities
+description: Commit as the right name and email for each repository.
+---
+
+# Git Identities
+
+A git identity is the name and email your commits are signed with. If you work across personal and work repos, you can save identities and apply the right one per repository, instead of relying on a single global setting. Manage them at **Settings → Git**.
+
+## Add an identity
+
+1. Open **Settings → Git** and choose **New**.
+2. Enter the **name** and **email** to commit with.
+3. Pick how it authenticates with the remote:
+   - **SSH** — point it at an SSH key
+   - **token** — use a saved credential for a host
+4. Optionally give it a color and icon so it's easy to spot.
+
+Your system's global identity is shown too, as read-only.
+
+## Apply an identity to a repo
+
+Applying an identity writes it to that repository's **local** git config — it only affects that repo, not your global setting. SSH identities also set the SSH command to use your key; token identities set up credential storage for the host.
+
+You can import identities OpenChamber discovers from your existing git credentials and save them as token identities.
+
+## Related
+
+- [Git & GitHub Workflows](/git/) — commit using the identity you set
+- [GitHub Issues & PRs](/github/) — connect a GitHub account for PRs

packages/docs/content/docs/git.mdx

@@ -0,0 +1,41 @@
+---
+title: Git & GitHub Workflows
+description: Stage, commit, and manage branches without leaving OpenChamber.
+---
+
+# Git & GitHub Workflows
+
+OpenChamber has a built-in git view so you can review changes, commit, and manage branches without switching to a terminal. Open it from the **Git** tab in the right sidebar.
+
+## Review and commit
+
+The git view splits your changes into **staged** and **unstaged**:
+
+- click a file's **+** to stage it, or **−** to unstage it
+- stage or unstage everything in a group at once
+- click a file to see its diff
+
+Then write a commit message and commit. You can have OpenChamber **generate a commit message** from your staged changes — it uses the current session's model, so you need a session open.
+
+## Branches and history
+
+The git view also covers the everyday rest of git:
+
+- create, switch, rename, and delete branches
+- push, pull, and fetch
+- browse history and per-commit diffs
+- stash and restore changes
+
+## Pull requests
+
+Connect GitHub (see [GitHub Issues & PRs](/github/)) and the **PR** tab lets you open a pull request, update it, mark it ready, or merge it — and generate its title and description the same way as commit messages.
+
+## Bringing in conflicts
+
+If a merge, rebase, or integrate hits a conflict, OpenChamber shows what's stuck and lets you resolve it — including handing it to the agent.
+
+## Related
+
+- [GitHub Issues & PRs](/github/) — connect GitHub and start work from issues
+- [Worktree Sessions](/worktrees/) — isolate a branch in its own folder
+- [Git Identities](/git-identities/) — commit as the right person per repo

packages/docs/content/docs/github.mdx

@@ -0,0 +1,34 @@
+---
+title: GitHub Issues & PRs
+description: Connect GitHub and start sessions from issues and pull requests.
+---
+
+# GitHub Issues & PRs
+
+Connect your GitHub account and OpenChamber can pull in issues and pull requests, start a session straight from one, and open or update PRs for you.
+
+## Connect GitHub
+
+1. Open **Settings → Git**.
+2. Under GitHub, choose **Connect**. OpenChamber shows a link and a short code.
+3. Open the link, enter the code, and approve.
+
+When it's connected, your account shows under the GitHub section. You can connect more than one account and switch between them, or disconnect at any time.
+
+## Start work from an issue or PR
+
+When you create a [worktree session](/worktrees/) with GitHub connected, you can choose **Start from GitHub issue/PR**:
+
+- pick an **issue** and OpenChamber names the branch after it and opens the session with the issue and its comments as the first message
+- pick a **pull request** and it checks out the PR's branch; you can include the PR's diff so the agent has the full change
+
+This drops you straight into a session with the context already loaded.
+
+## Open and manage pull requests
+
+From the **PR** tab in the [git view](/git/), you can create a pull request, update it, mark a draft as ready, or merge it. OpenChamber can generate the PR title and description from your changes.
+
+## Related
+
+- [Git & GitHub Workflows](/git/) — commit and manage branches
+- [Worktree Sessions](/worktrees/) — where issue and PR sessions start

packages/docs/content/docs/index.mdx

@@ -20,6 +20,13 @@ Use these docs to:
 - [Tunnels](/tunnels/)
 - [Troubleshooting](/troubleshooting/)
 
+## Explore
+
+- [Projects](/projects/) and [Worktree Sessions](/worktrees/) — organize and isolate your work
+- [Providers, Models & Agents](/providers/) — connect OpenCode and pick a model
+- [Git & GitHub Workflows](/git/) — commit, review, and open PRs
+- [Security](/security/) and [Tunnels](/tunnels/) — protect and reach your instance
+
 ## What OpenChamber is for
 
 OpenChamber is for the parts of AI coding that benefit from a control room: branching sessions, reviewing diffs, managing terminals, watching tool progress, running project actions, and keeping the full board visible while the agent works.

packages/docs/content/docs/ko/commands-snippets.mdx

@@ -0,0 +1,39 @@
+---
+title: 명령 및 스니펫
+description: 채팅에서 재사용할 수 있는 슬래시 명령과 텍스트 스니펫을 만드세요.
+---
+
+# 명령 및 스니펫
+
+명령과 스니펫은 모두 같은 내용을 다시 입력하는 수고를 덜어줍니다. 명령은 `/`로 실행하는 전체 프롬프트이고, 스니펫은 `#`로 메시지에 넣는 짧은 텍스트 조각입니다.
+
+## Commands
+
+명령은 `/review`처럼 슬래시로 실행하는 저장된 프롬프트입니다. **Settings → Commands**에서 관리합니다.
+
+1. **Settings → Commands**를 열고 명령을 만듭니다.
+2. 이름, 설명, 보낼 프롬프트 텍스트를 지정합니다.
+3. 필요하다면 특정 에이전트나 모델에 고정합니다.
+4. personal 또는 project 범위를 선택합니다.
+
+채팅에서 메시지의 **첫** 글자로 `/`를 입력하면 명령이 나타나며, 그중 하나를 선택합니다. 텍스트에는 플레이스홀더를 사용할 수 있습니다.
+
+- `$ARGUMENTS` — 명령 뒤에 입력한 내용
+- `@filename` — 파일의 내용을 삽입
+- `` !`command` `` — 셸 명령의 출력을 삽입
+
+내장된 `init`과 `review` 명령은 초기화할 수 있지만 삭제할 수는 없습니다.
+
+## Snippets
+
+스니펫은 `#signoff`처럼 해시태그로 인라인에서 참조하는 재사용 가능한 텍스트입니다. **Settings → Snippets**에서 관리합니다.
+
+1. **Settings → Snippets**를 열고 스니펫을 만듭니다.
+2. 이름과 대체할 텍스트를 지정합니다. 트리거를 여러 개 두려면 별칭을 추가합니다.
+3. personal 또는 project 범위를 선택합니다.
+
+채팅에서 `#`를 입력하고 스니펫을 선택합니다. OpenChamber가 보내기 전에 전체 텍스트로 바꿔 넣습니다.
+
+## 관련 항목
+
+- [Skills](/ko/skills/) — 더 큰 지침 모음을 필요할 때 불러오세요

packages/docs/content/docs/ko/context.mdx

@@ -0,0 +1,38 @@
+---
+title: 컨텍스트
+description: 세션이 모델의 메모리를 얼마나 사용하는지 확인하세요.
+---
+
+# 컨텍스트
+
+모든 모델은 한 번에 대화의 일정량만 담을 수 있습니다. 이것이 컨텍스트입니다. OpenChamber는 컨텍스트가 얼마나 찼는지 보여주므로, 세션이 한도에 가까워져 응답이 오래된 세부 내용을 버리기 시작할 시점을 알 수 있습니다.
+
+## 빠른 표시기
+
+채팅하는 동안 작은 게이지가 사용한 컨텍스트의 비율을 표시합니다. 채워질수록 색이 바뀝니다.
+
+- 초록색 — 여유 충분
+- 노란색 — 차고 있음(약 4분의 3)
+- 빨간색 — 거의 가득 참
+
+게이지에 마우스를 올리면(모바일에서는 탭하면) 정확한 토큰 수를 볼 수 있습니다.
+
+## 전체 컨텍스트 패널
+
+현재 세션을 더 자세히 보려면 오른쪽 사이드바의 **Context** 탭을 엽니다.
+
+- 사용 중인 모델과 세션 시작 시점
+- 모델 한도 대비 총 토큰 수
+- 메시지 및 비용 합계
+- 마지막 응답의 토큰 분석
+- 무엇이 컨텍스트를 차지하는지에 대한 대략적인 구분(사용자 메시지, 에이전트 메시지, 도구 출력)
+
+이 구분은 정확한 수치가 아니라 추정치입니다. 청구가 아니라 무엇이 창을 채우는지 파악하는 데 사용하세요.
+
+## 가득 찼을 때 할 일
+
+하나의 세션을 끝없이 키우지 말고 새 작업에는 새 세션을 시작하세요. 짧은 컨텍스트가 더 빠르고 모델을 집중시킵니다.
+
+## 관련 항목
+
+- [Projects](/ko/projects/) — 세션은 프로젝트별로 그룹화됩니다

packages/docs/content/docs/ko/desktop-browser.mdx

@@ -0,0 +1,22 @@
+---
+title: 데스크톱 브라우저
+description: 검사 및 콘솔 캡처 기능과 함께 데스크톱 앱 안에서 임의의 페이지를 탐색하세요.
+---
+
+# 데스크톱 브라우저
+
+데스크톱 앱에는 내장 브라우저가 있어 채팅 바로 옆에서 임의의 페이지를 열고, 요소를 가리켜 질문하고, 페이지의 콘솔을 캡처할 수 있습니다. 앱 헤더의 지구본 버튼에서 엽니다.
+
+> 데스크톱 브라우저는 **데스크톱 전용** 기능입니다. 웹에서는 [미리보기](/ko/preview/) 패널이 로컬 개발 서버에 대해 동일한 검사 및 콘솔 도구를 제공합니다.
+
+## 검사 및 주석
+
+**inspect**를 켜고 페이지의 임의 요소를 클릭합니다. OpenChamber가 그것이 무엇인지, 스타일, 위치, 스크린샷을 담은 메모를 캡처해 채팅 메시지에 첨부합니다. 에이전트에게 "바로 여기 이 요소"라고 알리는 가장 빠른 방법입니다.
+
+## 콘솔 캡처
+
+브라우저는 페이지의 콘솔 출력(오류, 경고, 로그)을 수집하므로 개발자 도구를 열지 않고도 필터링하여 읽을 수 있습니다.
+
+## 관련 항목
+
+- [Preview & Dev Servers](/ko/preview/) — 로컬 개발 서버에 대한 동일한 도구

packages/docs/content/docs/ko/git-identities.mdx

@@ -0,0 +1,30 @@
+---
+title: Git 아이덴티티
+description: 저장소마다 올바른 이름과 이메일로 커밋하세요.
+---
+
+# Git 아이덴티티
+
+git 신원은 커밋에 서명되는 이름과 이메일입니다. 개인 저장소와 업무 저장소를 오가며 작업한다면, 하나의 전역 설정에 의존하는 대신 신원을 저장해 두고 저장소마다 알맞은 것을 적용할 수 있습니다. **Settings → Git**에서 관리합니다.
+
+## 신원 추가하기
+
+1. **Settings → Git**를 열고 **New**를 선택합니다.
+2. 커밋에 사용할 **name**과 **email**을 입력합니다.
+3. 원격과 인증하는 방식을 선택합니다.
+   - **SSH** — SSH 키를 지정합니다
+   - **token** — 호스트에 저장된 자격 증명을 사용합니다
+4. 필요하다면 알아보기 쉽도록 색상과 아이콘을 지정합니다.
+
+시스템의 전역 신원도 읽기 전용으로 표시됩니다.
+
+## 저장소에 신원 적용하기
+
+신원을 적용하면 해당 저장소의 **local** git 설정에 기록됩니다. 전역 설정이 아니라 그 저장소에만 영향을 줍니다. SSH 신원은 사용자의 키를 사용하도록 SSH 명령도 설정하고, token 신원은 호스트용 자격 증명 저장소를 설정합니다.
+
+OpenChamber가 기존 git 자격 증명에서 찾아낸 신원을 가져와 token 신원으로 저장할 수 있습니다.
+
+## 관련 항목
+
+- [Git & GitHub Workflows](/ko/git/) — 설정한 신원으로 커밋하세요
+- [GitHub Issues & PRs](/ko/github/) — PR을 위해 GitHub 계정을 연결하세요

packages/docs/content/docs/ko/git.mdx

@@ -0,0 +1,41 @@
+---
+title: Git 및 GitHub 워크플로
+description: OpenChamber를 벗어나지 않고 스테이징, 커밋, 브랜치 관리를 하세요.
+---
+
+# Git 및 GitHub 워크플로
+
+OpenChamber에는 내장 git 보기가 있어 터미널로 전환하지 않고도 변경 사항을 검토하고, 커밋하고, 브랜치를 관리할 수 있습니다. 오른쪽 사이드바의 **Git** 탭에서 엽니다.
+
+## 검토 및 커밋
+
+git 보기는 변경 사항을 **staged**와 **unstaged**로 나눕니다.
+
+- 파일의 **+**를 클릭해 스테이징하거나 **−**를 클릭해 스테이징을 해제합니다
+- 그룹의 모든 항목을 한 번에 스테이징하거나 해제합니다
+- 파일을 클릭해 diff를 봅니다
+
+그런 다음 커밋 메시지를 작성하고 커밋합니다. OpenChamber가 스테이징된 변경 사항에서 **커밋 메시지를 생성**하게 할 수 있습니다. 현재 세션의 모델을 사용하므로 세션이 열려 있어야 합니다.
+
+## 브랜치와 히스토리
+
+git 보기는 일상적인 나머지 git 작업도 다룹니다.
+
+- 브랜치 생성, 전환, 이름 변경, 삭제
+- push, pull, fetch
+- 히스토리와 커밋별 diff 탐색
+- 변경 사항 stash 및 복원
+
+## 풀 리퀘스트
+
+GitHub를 연결하면([GitHub Issues & PRs](/ko/github/) 참고) **PR** 탭에서 풀 리퀘스트를 열고, 업데이트하고, 준비 완료로 표시하거나 병합할 수 있습니다. 그리고 커밋 메시지와 같은 방식으로 제목과 설명을 생성할 수 있습니다.
+
+## 충돌 가져오기
+
+병합, 리베이스, 통합이 충돌하면 OpenChamber가 무엇이 막혔는지 보여주고 해결하게 해줍니다. 에이전트에게 넘기는 것도 포함됩니다.
+
+## 관련 항목
+
+- [GitHub Issues & PRs](/ko/github/) — GitHub를 연결하고 이슈에서 작업을 시작하세요
+- [Worktree Sessions](/ko/worktrees/) — 브랜치를 자체 폴더에 격리하세요
+- [Git Identities](/ko/git-identities/) — 저장소마다 올바른 사람으로 커밋하세요

packages/docs/content/docs/ko/github.mdx

@@ -0,0 +1,34 @@
+---
+title: GitHub 이슈 및 PR
+description: GitHub를 연결하고 이슈와 풀 리퀘스트에서 세션을 시작하세요.
+---
+
+# GitHub 이슈 및 PR
+
+GitHub 계정을 연결하면 OpenChamber가 이슈와 풀 리퀘스트를 가져오고, 그중 하나에서 바로 세션을 시작하고, PR을 열거나 업데이트할 수 있습니다.
+
+## GitHub 연결하기
+
+1. **Settings → Git**를 엽니다.
+2. GitHub 아래에서 **Connect**를 선택합니다. OpenChamber가 링크와 짧은 코드를 표시합니다.
+3. 링크를 열고 코드를 입력한 뒤 승인합니다.
+
+연결되면 GitHub 섹션 아래에 계정이 표시됩니다. 계정을 여러 개 연결해 전환할 수 있으며, 언제든 연결을 해제할 수 있습니다.
+
+## 이슈나 PR에서 작업 시작하기
+
+GitHub가 연결된 상태에서 [worktree 세션](/ko/worktrees/)을 만들면 **Start from GitHub issue/PR**을 선택할 수 있습니다.
+
+- **issue**를 선택하면 OpenChamber가 그 이슈에 따라 브랜치 이름을 짓고, 이슈와 그 댓글을 첫 메시지로 하여 세션을 엽니다
+- **pull request**를 선택하면 PR의 브랜치를 체크아웃합니다. PR의 diff를 포함하면 에이전트가 전체 변경 사항을 갖게 됩니다
+
+이렇게 하면 컨텍스트가 이미 로드된 세션으로 바로 들어갑니다.
+
+## 풀 리퀘스트 열기 및 관리
+
+[git 보기](/ko/git/)의 **PR** 탭에서 풀 리퀘스트를 만들고, 업데이트하고, 초안을 준비 완료로 표시하거나 병합할 수 있습니다. OpenChamber는 변경 사항에서 PR 제목과 설명을 생성할 수 있습니다.
+
+## 관련 항목
+
+- [Git & GitHub Workflows](/ko/git/) — 커밋하고 브랜치를 관리하세요
+- [Worktree Sessions](/ko/worktrees/) — 이슈 및 PR 세션이 시작되는 곳

packages/docs/content/docs/ko/index.mdx

@@ -20,6 +20,13 @@ OpenChamber는 OpenCode(터미널에서 실행되는 AI 코딩 에이전트)를
 - [터널](/ko/tunnels/)
 - [문제 해결](/ko/troubleshooting/)
 
+## 더 둘러보기
+
+- [프로젝트](/ko/projects/)와 [Worktree 세션](/ko/worktrees/) — 작업을 정리하고 격리하세요
+- [공급자, 모델, 에이전트](/ko/providers/) — OpenCode를 연결하고 모델을 선택하세요
+- [Git 및 GitHub 워크플로](/ko/git/) — 커밋하고 검토하고 PR을 여세요
+- [보안](/ko/security/)과 [터널](/ko/tunnels/) — 인스턴스를 보호하고 접속하세요
+
 ## OpenChamber는 무엇을 위한 것인가
 
 OpenChamber는 관제 센터가 도움이 되는 AI 코딩 작업을 위한 것입니다. 세션 분기, diff 검토, 터미널 관리, 도구 진행 상황 관찰, 프로젝트 액션 실행, 그리고 에이전트가 작업하는 동안 전체 보드를 한눈에 유지하는 일입니다.

packages/docs/content/docs/ko/magic-prompts.mdx

@@ -0,0 +1,26 @@
+---
+title: 매직 프롬프트
+description: OpenChamber의 자동화 흐름 뒤에 있는 내장 프롬프트를 맞춤 설정하세요.
+---
+
+# 매직 프롬프트
+
+OpenChamber는 커밋 메시지 작성, PR 초안 작성, 이슈 검토, 충돌 해결, 세션 요약 같은 작업을 자동으로 할 때마다 뒤에서 내장 프롬프트를 사용합니다. Magic Prompts는 그러한 프롬프트를 읽고 다시 쓰는 곳입니다. **Settings → Magic Prompts**에서 엽니다.
+
+일반적인 사용에는 이 페이지가 필요하지 않습니다. 흐름이 다르게 동작하기를 원할 때, 예를 들어 특정 스타일의 커밋 메시지를 원할 때 사용하세요.
+
+## 프롬프트 편집하기
+
+1. **Settings → Magic Prompts**를 엽니다.
+2. 사이드바의 그룹(Git, GitHub, Planning, Session)에서 프롬프트를 선택합니다.
+3. 텍스트를 편집하고 저장합니다.
+
+일부 프롬프트에는 보이는 부분(사용자에게 표시되는 메시지)과 지침 부분(에이전트를 위한 숨겨진 안내)이 있습니다. 프롬프트에는 diff나 이슈 제목처럼 OpenChamber가 채워 넣는 `{{placeholders}}`가 포함될 수 있으니 그대로 두세요.
+
+## 초기화
+
+마음이 바뀌었나요? 각 프롬프트에는 **reset to default**가 있고, 모든 곳에서 처음부터 다시 시작하려면 **reset all**이 있습니다.
+
+## 관련 항목
+
+- [Git & GitHub Workflows](/ko/git/) — 이러한 프롬프트 중 다수가 git 흐름을 구동합니다

packages/docs/content/docs/ko/mcp.mdx

@@ -0,0 +1,30 @@
+---
+title: MCP 서버
+description: MCP 서버를 추가하여 에이전트에 추가 도구를 제공하세요.
+---
+
+# MCP 서버
+
+MCP 서버는 에이전트에 데이터베이스 검색, API 호출, 사용하는 서비스 읽기 같은 추가 도구를 제공합니다. **Settings → MCP**에서 추가합니다.
+
+## 서버 추가하기
+
+1. **Settings → MCP**를 엽니다.
+2. 서버를 추가하고 유형을 선택합니다.
+   - **local** — OpenChamber가 사용자의 컴퓨터에서 명령을 실행합니다. 실행할 명령과, 필요하다면 환경 변수를 제공합니다.
+   - **remote** — OpenChamber가 다른 누군가가 호스팅하는 URL에 연결합니다. URL과 필요한 헤더(예: 인증 토큰)를 제공합니다.
+3. 저장합니다. 서버는 기본적으로 켜져 있으며, 삭제하지 않고도 끌 수 있습니다.
+
+## 적용 범위
+
+서버를 추가할 때 범위를 선택합니다.
+
+- **personal** — 모든 프로젝트에서 사용 가능
+- **project** — 현재 프로젝트에서만 사용 가능하며, 프로젝트의 다른 설정과 함께 저장됨
+
+서버 이름에는 소문자, 숫자, 하이픈, 밑줄을 사용합니다.
+
+## 관련 항목
+
+- [Providers, Models & Agents](/ko/providers/) — 먼저 모델을 연결하세요
+- [Skills](/ko/skills/) — 에이전트의 기능을 확장하는 또 다른 방법

packages/docs/content/docs/ko/mobile.mdx

@@ -0,0 +1,31 @@
+---
+title: PWA 및 모바일 접속
+description: OpenChamber를 앱으로 설치하고 휴대폰에서 사용하세요.
+---
+
+# PWA 및 모바일 접속
+
+OpenChamber 웹 앱은 휴대폰 앱(PWA)처럼 설치되므로 홈 화면에 두고 전체 화면으로 사용할 수 있습니다. [터널](/ko/tunnels/)과 함께 사용하면 어디서든 세션을 확인할 수 있습니다.
+
+## 설치하기
+
+OpenChamber는 브라우저의 내장 설치 기능을 사용하므로 별도의 다운로드가 없습니다.
+
+- **데스크톱 브라우저** — 주소 표시줄의 **Install** 옵션을 사용합니다
+- **iPhone/iPad (Safari)** — 공유 → **홈 화면에 추가**
+- **Android (Chrome)** — 메뉴 → **앱 설치** / **홈 화면에 추가**
+
+설치되면 브라우저 크롬 없이 자체 창에서 열립니다.
+
+## 휴대폰에서 접근하기
+
+서버가 사용자의 컴퓨터에서 실행될 때 휴대폰에서 OpenChamber를 열려면 [터널](/ko/tunnels/)을 시작하고 휴대폰에서 링크를 열거나 QR 코드를 스캔합니다. 이렇게 할 때는 항상 강력한 [UI 비밀번호](/ko/security/)를 사용하세요.
+
+## 모바일 설정
+
+**Settings → OpenChamber** 아래의 몇 가지 옵션은 모바일 및 설치된 경험을 조정합니다. 앱의 설치 이름, 화면 방향, 화면 키보드의 동작 방식이 해당됩니다.
+
+## 관련 항목
+
+- [Tunnels](/ko/tunnels/) — 다른 네트워크에서 인스턴스에 접근하세요
+- [Security](/ko/security/) — 노출하기 전에 UI를 보호하세요

packages/docs/content/docs/ko/multi-run.mdx

@@ -0,0 +1,34 @@
+---
+title: Multi-run
+description: 동일한 프롬프트를 여러 모델이나 세션에서 한 번에 실행하세요.
+---
+
+# Multi-run
+
+Multi-run은 하나의 양식에서 여러 세션을 시작합니다. 같은 작업을 다른 모델로 시도하고 결과를 비교하는 데 유용합니다. 세션 사이드바 상단의 버튼에서 엽니다.
+
+## Multi-run 시작하기
+
+1. multi-run 런처를 엽니다.
+2. 프로젝트를 선택하고 실행 그룹의 이름을 지정합니다.
+3. 프롬프트를 작성하고 실행할 모델을 선택합니다(그룹당 최대 다섯 개).
+4. **isolate runs** 여부를 선택합니다.
+5. 시작합니다.
+
+각 모델은 자체 세션을 가지며, 모두 사용자의 프롬프트로 시작합니다.
+
+## 격리된 실행
+
+**isolate runs**를 켜면 모든 실행에 자체 [worktree](/ko/worktrees/)와 브랜치가 부여되어 같은 파일을 절대 건드리지 않습니다. 이를 위해서는 git 저장소가 필요하며, 저장소가 아닌 폴더에서는 자동으로 꺼집니다. 실행이 시작될 브랜치를 선택하세요.
+
+격리를 끄면 모든 실행은 프로젝트 폴더 안의 평범한 세션입니다.
+
+## 결과 비교하기
+
+각 실행은 열고, 읽고, 유지하거나 버릴 수 있는 일반 세션입니다. 접근 방식을 비교하려고 실행을 시작했다면 나란히 검토하고 가장 좋은 것을 이어가세요.
+
+단일 실행이 시작에 실패해도 나머지는 계속 시작됩니다. 요청한 것보다 세션이 적게 보일 뿐입니다.
+
+## 관련 항목
+
+- [Worktree Sessions](/ko/worktrees/) — 격리가 내부적으로 작동하는 방식

packages/docs/content/docs/ko/notes-todos-plans.mdx

@@ -0,0 +1,37 @@
+---
+title: 프로젝트 메모, 할 일, 계획
+description: 프로젝트마다 노트, 할 일 목록, 저장된 계획을 유지하세요.
+---
+
+# 프로젝트 메모, 할 일, 계획
+
+각 프로젝트에는 노트, 할 일 목록, 저장된 계획을 위한 자체 작업 공간이 있습니다. 이들은 특정 세션이 아니라 프로젝트에 속하므로 세션 사이를 오가도 그대로 유지됩니다. 오른쪽 사이드바의 **Context** 탭(모바일에서는 전용 탭)에서 찾을 수 있습니다.
+
+## Notes
+
+프로젝트에 대해 기억하고 싶은 것을 자유롭게 적는 노트 상자입니다. 입력하는 동안 자동으로 저장됩니다.
+
+## Todos
+
+간단한 체크리스트입니다. 항목을 추가하고, 체크하고, 드래그로 순서를 바꾸고, 완료된 항목을 정리합니다.
+
+각 할 일에는 에이전트에게 넘길 수 있는 **send** 메뉴가 있습니다.
+
+- 현재 세션으로 보내기
+- 그것으로 새 세션 시작
+- 그것으로 새 [worktree 세션](/ko/worktrees/) 시작(프로젝트가 git 저장소일 때만 가능)
+
+## Plans
+
+더 긴 계획을 저장된 파일로 보관하는 공간입니다. 다음을 할 수 있습니다.
+
+- Markdown 또는 텍스트 파일에서 계획 가져오기
+- 계획을 열어 사이드 패널에서 읽기
+- 더 이상 필요 없는 계획 삭제
+
+노트가 저장되거나, 할 일이 체크되거나, 계획이 목록에 표시된 상태로 Context 탭에 돌아와야 합니다. 그것으로 반영되었음을 알 수 있습니다.
+
+## 관련 항목
+
+- [Worktree Sessions](/ko/worktrees/) — 할 일을 자체 브랜치에서 실행하세요
+- [Projects](/ko/projects/) — 이들은 활성 프로젝트에 속합니다

packages/docs/content/docs/ko/notifications.mdx

@@ -0,0 +1,34 @@
+---
+title: 알림
+description: 세션이 사용자를 필요로 하거나 완료될 때 알림을 받으세요.
+---
+
+# 알림
+
+알림은 화면을 지켜보지 않아도 무언가가 사용자의 주의를 필요로 할 때, 즉 세션이 완료되었거나, 오류가 발생했거나, 질문했거나, 무언가를 할 권한이 필요할 때 알려줍니다. **Settings → OpenChamber → Notifications**에서 설정합니다.
+
+## 켜기
+
+1. **Settings → OpenChamber → Notifications**를 엽니다.
+2. 브라우저나 시스템이 요청하면 알림을 허용합니다.
+3. 알림받고 싶은 내용을 선택합니다.
+   - 세션 **완료**
+   - 세션 **오류** 발생
+   - 세션이 **질문**할 때
+   - 세션이 **권한**을 필요로 할 때
+   - **하위 작업** 완료
+
+## 전달 방식
+
+- **데스크톱**에서는 네이티브 시스템 알림을 받습니다
+- **브라우저 또는 설치된 앱**에서는 웹 푸시 알림을 받으므로 탭이 백그라운드에 있어도 도착합니다
+
+자동 수락으로 설정된 세션은 권한 알림으로 귀찮게 하지 않습니다.
+
+## 문구 맞춤 설정
+
+각 알림 종류에는 에이전트 이름과 모델 같은 필드를 사용해 편집할 수 있는 제목과 메시지 템플릿이 있습니다. 또한 알림이 짧게 유지되도록 마지막 메시지를 얼마나 포함할지에 대한 제한도 있습니다.
+
+## 관련 항목
+
+- [Voice Mode](/ko/voice/) — 대신 응답을 소리내어 들으세요

packages/docs/content/docs/ko/opencode-server.mdx

@@ -0,0 +1,54 @@
+---
+title: OpenCode 서버
+description: OpenChamber를 로컬 또는 원격 OpenCode 서버에 연결하세요.
+---
+
+# OpenCode 서버
+
+OpenChamber는 OpenCode 서버 위에서 실행됩니다. 기본적으로 OpenChamber가 서버를 직접 시작하므로 따로 할 일은 없습니다. 이미 운영 중인 서버를 OpenChamber가 사용하도록 지정하거나, OpenChamber가 시작한 서버를 관리하려는 경우에만 이 페이지가 필요합니다.
+
+## OpenChamber가 서버를 찾는 방법
+
+OpenChamber가 시작되면 다음 순서로 서버를 찾습니다.
+
+1. 이미 시작한 서버를 재사용합니다
+2. 외부 서버를 사용하도록 지정했다면 그 서버에 연결합니다(아래 참고)
+3. 기본 포트(`4096`)에서 서버를 자동으로 감지합니다
+4. 그 외에는 자체 서버를 시작하고 관리합니다
+
+아무것도 설정하지 않으면 4단계가 자동으로 실행되어 바로 사용할 수 있습니다.
+
+## 이미 운영 중인 서버에 연결하기
+
+OpenChamber를 시작하기 전에 다음을 설정하세요.
+
+```bash
+OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber
+```
+
+- `OPENCODE_HOST` — 포트를 포함한 OpenCode 서버의 전체 주소(예: `http://localhost:4096`)입니다. 끝에 경로가 붙어서는 안 됩니다.
+- `OPENCODE_SKIP_START=true` — OpenChamber가 자체 서버를 시작하지 않도록 지정합니다.
+
+포트만 변경하면 된다면 `OPENCODE_HOST` 대신 `OPENCODE_PORT`를 설정하세요.
+
+`OPENCODE_HOST`에 포트가 없거나 경로가 붙어 있으면 OpenChamber는 이를 무시하고 자체 서버를 시작하는 방식으로 되돌아갑니다. 예상한 연결이 일어나지 않았다면 시작 로그에서 `[config]` 경고를 확인하세요.
+
+## CLI에서 서버 관리하기
+
+```bash
+openchamber status
+openchamber logs
+openchamber restart
+openchamber stop
+```
+
+`openchamber`만 입력하면 서버가 백그라운드에서 시작됩니다. 터미널에 연결된 상태로 유지하려면 `--foreground`를 추가하세요.
+
+## "OpenCode is restarting"
+
+서버가 시작되거나 재시작되는 동안 OpenChamber는 "OpenCode is restarting" 상태를 표시하고 준비가 끝날 때까지 요청을 일시 중지합니다. 실행 직후나 재시작 직후에는 정상적인 동작입니다. 이 상태가 계속 사라지지 않으면 [OpenCode 연결](/ko/troubleshooting/opencode-connection/)을 참고하세요.
+
+## 관련 항목
+
+- [Providers, Models & Agents](/ko/providers/) — 서버가 통신할 대상을 설정합니다
+- [OpenCode 연결](/ko/troubleshooting/opencode-connection/) — 연결되지 않을 때

packages/docs/content/docs/ko/preview.mdx

@@ -0,0 +1,32 @@
+---
+title: 미리보기 및 개발 서버
+description: 실행 중인 개발 서버를 OpenChamber 안에서 여세요.
+---
+
+# 미리보기 및 개발 서버
+
+개발 서버를 시작하면 OpenChamber는 별도의 브라우저 탭이 아니라 앱 안에서 바로 열 수 있습니다. 그래서 채팅 옆에서 사이트를 보고, 콘솔을 캡처하고, 요소를 가리켜 질문할 수 있습니다.
+
+## 미리보기 열기
+
+OpenChamber는 터미널 출력에서 로컬 주소(Vite, Next.js, Astro 같은 도구가 출력하는 `Local:` 줄)를 감시합니다. 발견하면 다음과 같이 동작합니다.
+
+- 터미널에 **Open preview** 버튼이 나타납니다
+- auto-open이 켜진 [프로젝트 액션](/ko/project-actions/)이 대신 열어줍니다
+- 채팅 메시지의 로컬 링크로도 열 수 있습니다
+
+사이트는 사이드 패널에 로드됩니다. 로컬 주소(사용자 자신의 컴퓨터)만 미리볼 수 있습니다.
+
+## 콘솔과 검사
+
+미리보기 패널에서 다음을 할 수 있습니다.
+
+- 페이지의 **console**(오류, 경고, 로그)을 원하는 대로 필터링하여 확인
+- **inspect**를 켜고 임의의 요소를 클릭한 뒤 그에 대한 메모(선택자, 스타일, 위치, 스크린샷)를 바로 채팅으로 전송
+
+이것은 설명 없이 에이전트에게 "여기 이 버튼"이라고 알리는 가장 빠른 방법입니다.
+
+## 관련 항목
+
+- [Project Actions](/ko/project-actions/) — 서버를 시작할 때 자동으로 열기
+- [Desktop Browser](/ko/desktop-browser/) — 데스크톱에서 임의의 페이지에 동일한 도구 사용

packages/docs/content/docs/ko/project-actions.mdx

@@ -0,0 +1,28 @@
+---
+title: 프로젝트 작업
+description: 자주 실행하는 명령을 저장하고 클릭 한 번으로 실행하세요.
+---
+
+# 프로젝트 작업
+
+프로젝트 액션은 한 번 저장해 두고 클릭으로 실행하는 셸 명령입니다. 개발 서버, 빌드, 테스트 실행 등이 해당됩니다. 각 프로젝트는 자체 목록을 유지합니다. **Settings → Projects → Project Actions**에서 설정합니다.
+
+## 액션 추가하기
+
+1. **Settings → Projects**를 열고 **Project Actions** 섹션을 찾습니다.
+2. 액션을 추가하고 이름을 지정하고 아이콘을 선택하고 실행할 명령을 입력합니다.
+3. 저장합니다.
+
+명령이 특정 운영체제에서만 의미가 있다면 액션을 해당 운영체제로 제한할 수 있습니다.
+
+## 액션 실행하기
+
+액션은 앱 헤더의 메뉴에 있습니다. 하나를 클릭하면 OpenChamber가 프로젝트 폴더의 터미널에서 실행하고, 출력을 볼 수 있도록 터미널 보기로 전환합니다. 같은 메뉴에서 중지할 수 있습니다.
+
+## 개발 서버 자동 열기
+
+서버를 시작하는 액션에 **auto-open URL**을 켭니다. OpenChamber가 출력에서 로컬 주소를 감시하다가 열기를 제안합니다. [Preview & Dev Servers](/ko/preview/)를 참고하세요. 데스크톱에서는 SSH 포트 포워딩을 통해 라우팅할 수도 있습니다.
+
+## 관련 항목
+
+- [Preview & Dev Servers](/ko/preview/) — 실행 중인 개발 서버를 OpenChamber 안에서 여세요

packages/docs/content/docs/ko/project-icons.mdx

@@ -0,0 +1,20 @@
+---
+title: 프로젝트 아이콘
+description: 각 프로젝트에 알아보기 쉬운 아이콘을 지정하세요.
+---
+
+# 프로젝트 아이콘
+
+프로젝트 아이콘은 한눈에 프로젝트를 구분하기 쉽게 해줍니다. OpenChamber가 아이콘을 찾아주려고 시도하며, 언제든 직접 설정할 수 있습니다. **Settings → Projects**에서 관리합니다.
+
+## 자동 검색
+
+프로젝트를 추가하면 OpenChamber가 그 안의 `favicon` 파일을 찾아 프로젝트 아이콘으로 사용합니다. 저장소에 이미 favicon이 있으면 대개 아이콘이 그냥 나타나며, 할 일이 없습니다.
+
+## 직접 설정하기
+
+**Settings → Projects**를 열고 이미지(PNG, JPEG 또는 SVG, 최대 5 MB)를 업로드합니다. 사용자 지정 이미지는 자동으로 검색된 것보다 우선합니다. 대신 색상을 선택할 수도 있고, 이미지를 제거해 검색으로 되돌릴 수도 있습니다.
+
+## 관련 항목
+
+- [Projects](/ko/projects/) — 프로젝트의 이름, 색상을 정하고 정리하세요

packages/docs/content/docs/ko/projects.mdx

@@ -0,0 +1,34 @@
+---
+title: 프로젝트
+description: 작업을 프로젝트로 정리하고 그 사이를 전환하세요.
+---
+
+# 프로젝트
+
+프로젝트는 OpenChamber가 추적하는 사용자 컴퓨터의 폴더로, 보통 하나의 코드베이스입니다. 프로젝트를 전환하면 에이전트가 작업하는 폴더가 그 프로젝트의 세션 및 설정과 함께 전환됩니다.
+
+## 프로젝트 추가하기
+
+몇 군데에서 프로젝트를 추가할 수 있습니다.
+
+- 명령 팔레트의 **Add project** 항목
+- 세션 사이드바 상단의 **+** 버튼
+- 디렉터리를 선택할 때 나오는 폴더 브라우저
+
+폴더를 지정하면 OpenChamber가 기억합니다. 이름은 폴더에서 가져오며, 나중에 변경할 수 있습니다.
+
+## 프로젝트 전환하기
+
+사이드바에서 프로젝트를 선택하면 활성화됩니다. 세션, git, 노트 등 모든 것이 열려 있는 프로젝트를 따릅니다.
+
+## 프로젝트를 알아보기 쉽게 만들기
+
+**Settings → Projects**를 열어 프로젝트에 사용자 지정 이름, 색상, 아이콘을 지정합니다. OpenChamber는 아이콘을 자동으로 찾으려고 시도합니다. [Project icons](/ko/project-icons/)를 참고하세요.
+
+> VS Code에서는 OpenChamber가 항상 열려 있는 폴더를 유일한 프로젝트로 사용하므로 추가하거나 전환할 것이 없습니다. 거기서는 Projects 설정 페이지가 숨겨집니다.
+
+## 관련 항목
+
+- [Project Notes, Todos & Plans](/ko/notes-todos-plans/) — 프로젝트별로 작업 노트를 유지하세요
+- [Project Actions](/ko/project-actions/) — 자주 실행하는 명령을 저장하세요
+- [Context](/ko/context/) — 세션이 모델의 메모리를 얼마나 사용하는지 확인하세요

packages/docs/content/docs/ko/providers.mdx

@@ -0,0 +1,49 @@
+---
+title: 공급자, 모델, 에이전트
+description: AI 공급자를 연결하고 모델을 선택하며 에이전트를 설정하세요.
+---
+
+# 공급자, 모델, 에이전트
+
+OpenChamber가 무언가를 하려면 먼저 최소한 하나의 AI 공급자가 연결되어 있어야 합니다. 이 페이지에서는 공급자 연결, 모델 선택, 에이전트 맞춤 설정을 다룹니다.
+
+## 공급자 연결하기
+
+1. **Settings → Providers**를 엽니다.
+2. **Add provider** 메뉴를 열고 아직 연결되지 않은 공급자를 선택합니다.
+3. 공급자에 따라 다음 두 가지 방법 중 하나로 로그인합니다.
+   - **API key** — 키를 붙여넣고 저장합니다.
+   - **Sign-in (device flow)** — OpenChamber가 링크와 짧은 코드를 표시합니다. 링크를 열고 코드를 입력한 뒤 승인합니다. 나머지 연결은 OpenChamber가 알아서 마무리합니다.
+
+공급자가 연결됨으로 표시되면 해당 모델을 채팅에서 사용할 수 있습니다.
+
+연결을 해제하려면 공급자를 열고 로그인을 제거하도록 선택합니다.
+
+## 모델 선택하기
+
+작업하는 위치에서 모델을 선택합니다.
+
+- 채팅에서는 메시지 바의 모델 선택기로 해당 세션의 공급자와 모델을 설정합니다
+- 에이전트별로 기본 모델을 설정합니다(아래 참고)
+
+## 에이전트 설정하기
+
+에이전트는 모델, 성격, 허용된 작업을 묶어 이름을 붙인 설정입니다.
+
+1. **Settings → Agents**를 엽니다.
+2. 에이전트를 선택하거나 새로 만듭니다.
+3. 다음 항목을 편집합니다.
+   - **description** — 에이전트의 용도
+   - **model** — 기본 모델
+   - **temperature** — 답변의 창의성 정도
+   - **prompt** — 항상 따르는 상시 지침
+   - **tool rules** — 사용할 수 있는 도구
+
+## 로그인 정보가 저장되는 위치
+
+공급자 로그인 정보는 OpenChamber가 아니라 OpenCode에 저장되므로 OpenCode CLI와 공유됩니다. 같은 공급자를 여러 곳에 설정하면 가장 구체적인 설정이 우선합니다. 프로젝트별 설정이 개인 설정을 덮어씁니다.
+
+## 관련 항목
+
+- [MCP Servers](/ko/mcp/) — 에이전트에 추가 도구를 제공합니다
+- [Usage & Quotas](/ko/usage/) — 사용량을 추적합니다

packages/docs/content/docs/ko/remote-instances.mdx

@@ -0,0 +1,30 @@
+---
+title: 원격 인스턴스
+description: 데스크톱 앱을 SSH로 다른 컴퓨터의 OpenChamber에 연결하세요.
+---
+
+# 원격 인스턴스
+
+데스크톱 앱은 SSH를 통해 업무 서버, 클라우드 인스턴스, 홈랩 등 다른 컴퓨터에서 실행 중인 OpenChamber에 연결하여, 마치 로컬인 것처럼 그 UI를 화면에 가져올 수 있습니다. **Settings → Remote Instances**에서 설정합니다.
+
+> 원격 인스턴스는 **데스크톱 전용** 기능입니다. 웹이나 VS Code에서는 대신 [OpenCode Server](/ko/opencode-server/)의 환경 변수로 원격 서버에 연결하세요.
+
+## 원격 인스턴스 추가하기
+
+1. **Settings → Remote Instances**를 열고 하나를 추가합니다.
+2. 평소에 그 컴퓨터에 접근할 때 사용하는 SSH 명령과 별칭을 지정합니다.
+3. OpenChamber가 거기서 실행되는 방식을 선택합니다.
+   - **managed** — OpenChamber가 원격 컴퓨터에 직접 설치하고 시작합니다
+   - **external** — 이미 실행 중인 것에 연결합니다
+4. 연결합니다.
+
+OpenChamber가 연결 확인, 원격 설정, 서버 시작, 포트 포워딩 단계를 안내하며 각 단계의 진행 상황을 보여줍니다. **ready**에 도달하면 원격 UI가 로컬에 로드됩니다.
+
+## 자격 증명
+
+SSH 및 UI 비밀번호를 저장할지, 매번 입력할지 결정합니다. 연결이 끊기면 OpenChamber가 어느 단계가 실패했는지 알려주므로 고칠 수 있습니다. [Remote access](/ko/troubleshooting/remote-access/)를 참고하세요.
+
+## 관련 항목
+
+- [OpenCode Server](/ko/opencode-server/) — 웹이나 VS Code에서 원격 서버에 연결하세요
+- [Remote access](/ko/troubleshooting/remote-access/) — 연결이 완료되지 않을 때

packages/docs/content/docs/ko/scheduled-tasks.mdx

@@ -0,0 +1,33 @@
+---
+title: 예약 작업
+description: 일정에 따라 프롬프트를 자동으로 실행하세요.
+---
+
+# 예약 작업
+
+예약 작업은 일정에 따라 프롬프트를 대신 실행합니다. 예를 들어 매일 "어제 변경 사항 요약"이나 주간 정리 같은 것입니다. 실행되면 OpenChamber가 새 세션을 시작하고 프롬프트를 알아서 보냅니다. 세션 사이드바 상단의 버튼에서 스케줄러를 엽니다.
+
+## 작업 만들기
+
+1. 세션 사이드바에서 예약 작업 대화 상자를 엽니다.
+2. 작업을 추가하고 이름을 지정합니다.
+3. 실행 시점을 선택합니다.
+   - **daily** — 매일 하나 이상의 시각에
+   - **weekly** — 선택한 요일과 시각에
+   - **once** — 단일 날짜와 시각에
+4. 동작을 설정합니다. 보낼 프롬프트와 사용할 공급자, 모델, 에이전트를 지정합니다. 프롬프트는 `/review`처럼 슬래시 명령일 수 있습니다.
+5. 저장하고 작업이 활성화되어 있는지 확인합니다.
+
+**run now**로 작업을 즉시 실행하여 기대대로 동작하는지 확인할 수 있습니다.
+
+## 성공이란 어떤 모습인가
+
+실행 후 작업에는 마지막 실행 시각, 성공 여부, 생성된 세션으로의 링크가 표시됩니다. 실행이 실패하면 오류도 거기에 표시됩니다.
+
+## 유의할 점
+
+작업은 OpenChamber 서버가 실행 중일 때만 동작합니다. 서버를 닫으면 다시 켤 때까지 예약 실행이 일시 중지됩니다.
+
+## 관련 항목
+
+- [Commands & Snippets](/ko/commands-snippets/) — 슬래시 명령을 프롬프트로 재사용하세요

packages/docs/content/docs/ko/security.mdx

@@ -0,0 +1,37 @@
+---
+title: 보안
+description: 노출하기 전에 비밀번호와 패스키로 UI를 보호하세요.
+---
+
+# 보안
+
+OpenChamber는 사용자의 컴퓨터와 코드에 대한 접근 권한을 제공하므로, 본인 외의 누군가가 접근할 수 있게 되기 전에 잠가 두세요. 이 페이지는 UI 비밀번호, 패스키, 그리고 OpenChamber를 네트워크에 노출하기 전에 알아야 할 사항을 다룹니다.
+
+## UI 비밀번호 설정하기
+
+비밀번호와 함께 OpenChamber를 시작하면 브라우저 UI가 비밀번호를 요구합니다.
+
+```bash
+openchamber --ui-password be-creative-here
+```
+
+명령줄에 넣는 대신 `OPENCHAMBER_UI_PASSWORD` 환경 변수로 설정할 수도 있습니다. 로그인하면 OpenChamber가 한동안 기기를 기억하므로 매번 묻지 않습니다.
+
+다른 사람이 인스턴스에 접근할 수 있다면, 특히 [터널](/ko/tunnels/)이나 공용 인터넷을 통해 접근할 수 있다면 항상 비밀번호를 설정하세요.
+
+## 패스키
+
+비밀번호가 설정되면 더 빠른 로그인을 위해 패스키(Face ID, Touch ID, 보안 키)를 추가할 수 있습니다. **Settings → OpenChamber → Passkeys**에서 추가하세요.
+
+패스키는 현재 비밀번호에 연결됩니다. 비밀번호를 변경하거나 제거하면 저장된 패스키가 삭제되며, 다시 추가해야 합니다.
+
+## 노출하기 전에
+
+- 기본적으로 OpenChamber는 사용자 자신의 컴퓨터(`127.0.0.1`)에서만 수신 대기합니다. 더 넓게 수신 대기하려면 의도적인 변경이 필요하며, 먼저 비밀번호를 설정해야 합니다.
+- 인터넷에 포트를 여는 것보다 [터널](/ko/tunnels/)이나 사설 네트워크(예: VPN)를 선호하세요.
+- OpenChamber를 자체 HTTPS 서버 뒤에 둔다면 [Reverse Proxy](/ko/reverse-proxy/)를 참고하세요.
+
+## 관련 항목
+
+- [Tunnels](/ko/tunnels/) — 원격으로 인스턴스에 접근하는 권장 방법
+- [Reverse Proxy](/ko/reverse-proxy/) — 자체 서버 뒤에서 OpenChamber 실행

packages/docs/content/docs/ko/skills-catalog.mdx

@@ -0,0 +1,27 @@
+---
+title: 스킬 카탈로그
+description: 이미 만들어진 스킬을 둘러보고 설치하세요.
+---
+
+# 스킬 카탈로그
+
+Skills Catalog를 사용하면 직접 작성하는 대신 다른 사람이 게시한 스킬을 설치할 수 있습니다. **Settings → Skills → Catalog**에서 엽니다.
+
+직접 스킬을 작성하려면 [Skills](/ko/skills/)를 참고하세요.
+
+## 스킬 설치하기
+
+1. 카탈로그를 엽니다.
+2. 내장된 소스(Anthropic 스킬 저장소와 ClawdHub 커뮤니티 레지스트리)를 둘러보거나 검색합니다.
+3. 스킬을 선택하고 설치합니다.
+4. 설치 위치를 선택합니다. 모든 작업에 적용할지, 현재 프로젝트에만 적용할지 선택합니다.
+
+같은 이름의 스킬이 이미 있으면 OpenChamber가 어떻게 할지 묻습니다. 건너뛰기, 덮어쓰기, 또는 스킬별로 결정할 수 있습니다.
+
+## 직접 소스 추가하기
+
+`owner/repo` 이름이나 전체 Git URL을 사용해 임의의 Git 저장소를 소스로 추가할 수 있습니다. 비공개 저장소는 사용자의 컴퓨터에 접근 설정(SSH 키 또는 저장된 자격 증명)이 필요합니다. 소스가 인증에 실패하면 카탈로그가 조용히 실패하는 대신 그 사실을 알려줍니다.
+
+## 관련 항목
+
+- [Skills](/ko/skills/) — 설치한 스킬을 만들고 관리하세요

packages/docs/content/docs/ko/skills.mdx

@@ -0,0 +1,30 @@
+---
+title: 스킬
+description: 에이전트가 필요할 때 불러오는 재사용 가능한 지침을 만드세요.
+---
+
+# 스킬
+
+스킬은 에이전트가 관련이 있을 때 불러올 수 있는 재사용 가능한 지침 모음입니다. 예를 들어 "커밋 메시지를 작성하는 방식"이나 "우리의 API 규칙" 같은 것입니다. **Settings → Skills**에서 관리합니다.
+
+직접 작성하는 대신 이미 만들어진 스킬을 설치하려면 [Skills Catalog](/ko/skills-catalog/)를 참고하세요.
+
+## 스킬 만들기
+
+1. **Settings → Skills**를 엽니다.
+2. 스킬을 만들고 이름과 짧은 설명을 지정합니다. 에이전트는 이 설명을 보고 스킬이 적용될 시점을 판단하므로 구체적으로 작성하세요.
+3. 지침을 작성합니다. 스킬에 필요하다면 보조 파일을 추가합니다.
+4. 저장 위치를 선택합니다.
+   - **personal** — 모든 프로젝트에서 사용 가능
+   - **project** — 현재 프로젝트에서만 사용 가능
+
+## 채팅에서 스킬 사용하기
+
+메시지 중간에 `/`를 입력하면 스킬 선택기가 나타나며, 그중 하나를 선택합니다. 에이전트가 해당 스킬의 지침을 응답에 불러옵니다.
+
+메시지 맨 앞의 `/`는 대신 [명령](/ko/commands-snippets/)을 엽니다.
+
+## 관련 항목
+
+- [Skills Catalog](/ko/skills-catalog/) — 다른 사람이 게시한 스킬을 설치하세요
+- [Commands & Snippets](/ko/commands-snippets/) — 채팅에서 텍스트를 재사용하는 다른 방법

packages/docs/content/docs/ko/troubleshooting/opencode-connection.mdx

@@ -0,0 +1,34 @@
+---
+title: OpenCode 연결
+description: OpenChamber가 OpenCode 서버에 연결되지 않는 문제를 해결하세요.
+---
+
+# OpenCode 연결
+
+OpenChamber가 로드되지만 "OpenCode is restarting"에서 넘어가지 못하거나 채팅이 응답하지 않는다면, 통신하는 서버에 접근할 수 없는 상태입니다. 다음을 차례로 확인하세요.
+
+## "OpenCode is restarting"에서 멈춰 있음
+
+- 실행 직후에는 잠시 기다리세요. 서버가 시작되는 동안에는 정상적인 상태입니다
+- `openchamber status`로 서버가 살아 있는지 확인합니다
+- `openchamber restart`로 재시작합니다
+- `openchamber logs`로 시작 세부 정보를 봅니다
+
+## 직접 운영하는 서버에 연결 중
+
+OpenChamber가 기존 서버를 사용하도록 설정했다면 [OpenCode Server](/ko/opencode-server/)의 설정을 다시 확인하세요.
+
+- `OPENCODE_HOST`에는 포트가 포함되어야 하며 경로가 없어야 합니다(예: `http://localhost:4096`)
+- OpenChamber가 자체 서버를 함께 시작하지 않도록 `OPENCODE_SKIP_START=true`를 설정합니다
+- 주소가 올바르지 않으면 OpenChamber가 이를 무시하고 자체 서버를 시작합니다. 로그에서 `[config]` 경고를 찾아보세요
+
+## 여전히 실패함
+
+- Node.js 버전이 `20` 이상인지 확인합니다
+- 최신 CLI를 다시 설치합니다
+- 터널이나 원격 링크를 테스트하기 전에 `http://localhost:3000`을 직접 엽니다
+
+## 관련 항목
+
+- [OpenCode Server](/ko/opencode-server/) — OpenChamber가 서버를 찾고 관리하는 방법
+- [문제 해결](/ko/troubleshooting/) — 다른 일반적인 문제

packages/docs/content/docs/ko/troubleshooting/remote-access.mdx

@@ -0,0 +1,38 @@
+---
+title: 원격 접속
+description: 터널, 원격 인스턴스, 다른 기기에서 OpenChamber에 접근하는 문제를 해결하세요.
+---
+
+# 원격 접속
+
+휴대폰이나 다른 컴퓨터에서 OpenChamber에 접근할 수 없을 때, 해결 방법은 연결 방식에 따라 다릅니다.
+
+## 먼저 기본 사항 확인
+
+- 같은 컴퓨터에서 `http://localhost:3000`을 먼저 엽니다. 이것이 실패하면 원격 문제가 아닙니다. [OpenCode 연결](/ko/troubleshooting/opencode-connection/)을 참고하세요
+- `openchamber status`로 서버가 실행 중인지 확인합니다
+
+## 터널 링크가 작동하지 않음
+
+- `openchamber tunnel status --all`을 실행합니다
+- 같은 인스턴스와 포트에서 터널을 재시작합니다
+- 이전 링크가 이미 사용되었다면 연결 링크를 다시 생성합니다
+
+전체 설정은 [Tunnels](/ko/tunnels/)를 참고하세요.
+
+## 원격 인스턴스가 연결되지 않음(데스크톱)
+
+[원격 인스턴스](/ko/remote-instances/)가 멈추면 OpenChamber가 실패한 단계를 알려줍니다.
+
+- **auth** — SSH 또는 UI 비밀번호가 거부됨. 다시 입력하세요
+- **install / start** — OpenChamber가 원격 컴퓨터에서 서버를 설정하거나 시작하지 못함. 그 컴퓨터의 요구 사항을 확인하세요
+- **forwarding** — 연결은 되었지만 포트가 도달하지 않음. 다른 로컬 포트를 시도하세요
+
+## 자체 서버 뒤에 있음
+
+OpenChamber를 리버스 프록시 뒤에 두었는데 이상하게 로드되거나 연결되지 않으면 [Reverse Proxy](/ko/reverse-proxy/)를 참고하세요.
+
+## 관련 항목
+
+- [Tunnels](/ko/tunnels/) · [Remote Instances](/ko/remote-instances/) · [Reverse Proxy](/ko/reverse-proxy/)
+- [Security](/ko/security/) — 노출하기 전에 UI를 보호하세요

packages/docs/content/docs/ko/troubleshooting/worktrees-git.mdx

@@ -0,0 +1,35 @@
+---
+title: Worktree 및 Git
+description: 일반적인 worktree 및 git 문제를 해결하세요.
+---
+
+# Worktree 및 Git
+
+[worktree 세션](/ko/worktrees/)과 [git 보기](/ko/git/)에서 발생하는 문제와 해결 방법입니다.
+
+## worktree에 주의가 필요함
+
+OpenChamber는 무언가 잘못되면 worktree를 표시합니다.
+
+- **folder missing** — worktree의 폴더가 OpenChamber 외부에서 삭제되거나 이동됨. 세션을 제거하고 새 worktree를 만드세요
+- **detached or unborn branch** — worktree가 정상적인 브랜치에 있지 않음. 정상 브랜치로 체크아웃하세요
+- **merge, rebase, or cherry-pick in progress** — 작업이 절반만 끝남. git 보기에서 완료하거나 중단하세요
+
+## worktree를 만들 수 없음
+
+- **branch already exists** — 다른 브랜치 이름을 선택하거나 existing-branch 옵션을 사용하세요
+- **name already in use** — 다른 worktree 이름을 선택하세요
+
+## 커밋 또는 PR 생성 실패
+
+커밋 메시지나 PR 설명 생성은 활성 세션에서 실행되므로, 작동하는 모델이 선택된 세션이 열려 있어야 합니다. 세션을 열거나 선택한 뒤 다시 시도하세요.
+
+## SSH 또는 Windows 경로 문제
+
+- 저장소가 사용하는 SSH 키가 [git 신원](/ko/git-identities/)에 설정된 것과 같은지 확인하세요
+- Windows에서 git은 Unix 스타일 경로(예: `/c/Users/...`)를 사용합니다. OpenChamber가 이를 처리하지만, 사용자 지정 SSH 키 경로도 같은 형식을 따라야 합니다
+
+## 관련 항목
+
+- [Worktree Sessions](/ko/worktrees/) — worktree가 생성되고 제거되는 방법
+- [Git Identities](/ko/git-identities/) — 저장소마다 올바른 키와 신원을 설정하세요

packages/docs/content/docs/ko/tunnels.mdx

@@ -80,4 +80,6 @@ openchamber tunnel stop --port 3000
 
 ## 관련 문서
 
+- [보안](/ko/security/) — 외부에 공개하기 전에 UI를 보호하세요
+- [PWA 및 모바일 접속](/ko/mobile/) — 휴대폰에서 OpenChamber에 접속하세요
 - [문제 해결](/ko/troubleshooting/) — 터널 링크가 작동하지 않을 때

packages/docs/content/docs/ko/updates.mdx

@@ -0,0 +1,31 @@
+---
+title: 업데이트
+description: 데스크톱, 웹, VS Code에서 OpenChamber를 최신 상태로 유지하세요.
+---
+
+# 업데이트
+
+OpenChamber를 업데이트하는 방법은 설치 방식에 따라 다릅니다. 어떤 경우든 **Settings → OpenChamber → About**에서 현재 버전을 확인할 수 있습니다.
+
+## 데스크톱 앱
+
+데스크톱 앱은 GitHub 릴리스를 기준으로 업데이트를 확인합니다. 업데이트가 있으면 OpenChamber가 알려주고, 선택하면 다운로드한 뒤 다음 재시작 때 설치합니다. 항상 사용자가 제어하며, 동의 없이는 아무것도 설치되지 않습니다.
+
+## 웹 / CLI
+
+CLI를 설치했다면 **About**의 확인 및 업데이트 버튼으로 업데이트하거나, 터미널에서 업데이트합니다.
+
+```bash
+openchamber update
+```
+
+OpenChamber는 설치 방식(npm, pnpm, yarn 또는 bun)을 감지하여 알맞은 업데이트를 실행합니다.
+
+## OpenCode 서버
+
+OpenChamber와 OpenCode는 별도로 업데이트됩니다. 새 OpenCode 버전이 있으면 OpenChamber가 업데이트를 제안하고, 이후 서버를 재시작합니다. 그 서버가 관리되는 방식은 [OpenCode Server](/ko/opencode-server/)를 참고하세요.
+
+## 관련 항목
+
+- [Install](/ko/install/) — 각 앱이 처음에 설치되는 방법
+- [OpenCode Server](/ko/opencode-server/) — 기반 서버 업데이트

packages/docs/content/docs/ko/usage.mdx

@@ -0,0 +1,28 @@
+---
+title: 사용량 및 할당량
+description: 공급자 요금제를 얼마나 사용했는지 추적하세요.
+---
+
+# 사용량 및 할당량
+
+Usage 페이지는 각 공급자 요금제를 얼마나 사용했는지 보여주므로 한도에 얼마나 가까운지 확인할 수 있습니다. **Settings → Usage**에서 엽니다.
+
+## 표시되는 내용
+
+연결된 각 공급자에 대해 OpenChamber는 다음을 표시합니다.
+
+- 현재 기간 동안 사용한 양을 막대로 표시
+- 모델별 분석
+- 한도에 도달할 추세인지 알 수 있는 사용 속도 지표
+
+어떤 공급자를 표시할지 선택할 수 있으며, 동일한 요약은 앱 헤더의 드롭다운에서도 확인할 수 있습니다.
+
+## 지원되는 공급자
+
+Usage는 Claude, Codex, GitHub Copilot, Google, OpenRouter, Kimi, NanoGPT, z.ai, Zhipu, MiniMax, Ollama Cloud, Wafer를 포함해 할당량을 공개하는 공급자에서 작동합니다.
+
+공급자는 [Providers](/ko/providers/) 페이지에서 로그인한 뒤에만 사용량을 표시합니다. 일부 공급자는 추가 단계가 필요합니다. 예를 들어 Ollama Cloud는 별도로 설정한 세션 파일을 읽습니다. 공급자에 데이터가 표시되지 않는다면 대개 그 추가 자격 증명이 누락된 것입니다.
+
+## 관련 항목
+
+- [Providers, Models & Agents](/ko/providers/) — 사용량이 표시되기 전에 로그인하세요

packages/docs/content/docs/ko/voice.mdx

@@ -0,0 +1,36 @@
+---
+title: 음성 모드
+description: OpenChamber에 말하고 응답을 소리내어 들으세요.
+---
+
+# 음성 모드
+
+음성 모드를 사용하면 메시지를 받아쓰게 하고 응답을 소리내어 들을 수 있습니다. **Settings → OpenChamber → Voice**에서 켭니다.
+
+## 응답을 소리내어 읽기(text-to-speech)
+
+응답을 읽는 방식을 선택합니다.
+
+- **browser** — 브라우저의 내장 음성, 설정 불필요
+- **OpenAI** — OpenAI의 음성. API 키를 붙여넣고 음성을 선택합니다
+- **OpenAI-compatible** — OpenAI 형식을 지원하는 모든 서비스. URL과, 필요하다면 API 키를 입력합니다
+- **macOS say** — 내장 `say` 명령. 이를 지원하는 Mac에서 사용 가능
+
+켜면 메시지에 재생 버튼이 생겨 소리내어 들을 수 있습니다.
+
+## 메시지 받아쓰기(speech-to-text)
+
+음성을 텍스트로 변환하는 방식을 선택합니다.
+
+- **browser** — 브라우저의 내장 인식, 설정 불필요
+- **server** — OpenAI 호환 변환 서비스. URL과, 필요하다면 API 키를 입력합니다
+- **on-device** — 브라우저에서 실행되며 처음 사용할 때 다운로드되는 음성 모델
+
+## 휴대폰 관련 참고 사항
+
+휴대폰에서 응답을 소리내어 읽을 때는 OpenAI 또는 OpenAI-compatible 옵션이 가장 안정적입니다. 모바일 브라우저는 내장 음성을 제한합니다.
+
+## 관련 항목
+
+- [Notifications](/ko/notifications/) — 듣는 대신 알림을 받으세요
+- [Providers, Models & Agents](/ko/providers/) — OpenAI 키가 이미 저장되어 있을 수 있는 곳

packages/docs/content/docs/ko/worktrees.mdx

@@ -0,0 +1,36 @@
+---
+title: Worktree 세션
+description: 세션에 자체 브랜치와 폴더를 부여하여 작업을 격리하세요.
+---
+
+# Worktree 세션
+
+worktree 세션은 자체 브랜치 위에서 체크아웃된 저장소 사본으로 실행됩니다(git worktree). 그래서 병렬 세션이 서로의 파일을 건드리지 않으며, 한 세션이 리팩터링하는 동안 다른 세션이 버그를 고칠 수 있고 오갈 필요가 없습니다.
+
+## 만들기
+
+1. 세션 사이드바 상단의 버튼에서 새 worktree 대화 상자를 엽니다.
+2. 시작 지점을 선택합니다.
+   - **new branch** — 브랜치 이름을 지정하고 어느 브랜치에서 시작할지 선택합니다
+   - **existing branch** — 이미 가지고 있는 브랜치를 체크아웃합니다
+3. worktree 폴더를 확인합니다(OpenChamber가 브랜치 이름에서 하나를 제안합니다).
+4. 만듭니다.
+
+OpenChamber가 브랜치를 만들고 폴더를 설정한 뒤 그 안에서 세션을 시작합니다. [할 일](/ko/notes-todos-plans/)이나 [GitHub 이슈 또는 PR](/ko/github/)에서 바로 시작할 수도 있습니다.
+
+## 작업 되돌려 가져오기
+
+작업이 만족스러우면 Git 보기에서 **Integrate**를 사용해 worktree의 커밋을 다른 브랜치(예: `main`)로 가져옵니다. 변경 사항이 충돌하면 충돌을 에이전트에게 넘겨 해결하게 할 수 있습니다.
+
+## 정리하기
+
+세션을 삭제하거나 보관하면 worktree를 제거할 수 있습니다. 로컬 브랜치와, 있다면 원격 브랜치까지 함께 삭제할지 선택합니다. 요청하지 않으면 아무것도 삭제되지 않습니다.
+
+## 무언가 잘못된 것처럼 보이면
+
+worktree는 폴더가 사라졌거나, 브랜치가 detached 상태이거나, 병합 또는 리베이스가 절반만 끝난 경우 주의가 필요할 수 있습니다. OpenChamber가 이를 표시하여 고칠 수 있게 합니다. [Worktrees & Git](/ko/troubleshooting/worktrees-git/)을 참고하세요.
+
+## 관련 항목
+
+- [Multi-run](/ko/multi-run/) — 여러 worktree 세션을 한 번에 시작하세요
+- [Git & GitHub Workflows](/ko/git/) — OpenChamber 안에서 커밋하고 통합하세요

packages/docs/content/docs/magic-prompts.mdx

@@ -0,0 +1,26 @@
+---
+title: Magic Prompts
+description: Customize the built-in prompts behind OpenChamber's automated flows.
+---
+
+# Magic Prompts
+
+OpenChamber uses built-in prompts behind the scenes whenever it does something automatically — writing a commit message, drafting a PR, reviewing an issue, resolving a conflict, summarizing a session. Magic Prompts is where you read and rewrite those prompts. Open it at **Settings → Magic Prompts**.
+
+You don't need this page for normal use. Reach for it when you want a flow to behave differently — say, commit messages in a particular style.
+
+## Edit a prompt
+
+1. Open **Settings → Magic Prompts**.
+2. Pick a prompt from the groups in the sidebar — Git, GitHub, Planning, and Session.
+3. Edit the text and save.
+
+Some prompts have a visible part (the message you'd see) and an instructions part (hidden guidance for the agent). Prompts can include `{{placeholders}}` that OpenChamber fills in, like the diff or the issue title — keep those in place.
+
+## Reset
+
+Changed your mind? Each prompt has **reset to default**, and there's a **reset all** if you want to start over everywhere.
+
+## Related
+
+- [Git & GitHub Workflows](/git/) — many of these prompts power the git flows

packages/docs/content/docs/mcp.mdx

@@ -0,0 +1,30 @@
+---
+title: MCP Servers
+description: Add MCP servers to give agents extra tools.
+---
+
+# MCP Servers
+
+An MCP server gives your agents extra tools — things like searching a database, calling an API, or reading a service you use. Add them in **Settings → MCP**.
+
+## Add a server
+
+1. Open **Settings → MCP**.
+2. Add a server and choose its type:
+   - **local** — OpenChamber runs a command on your machine. You give it the command to run and, if needed, environment variables.
+   - **remote** — OpenChamber connects to a URL someone else hosts. You give it the URL and any headers it needs (for example an auth token).
+3. Save. The server is on by default; you can turn it off without deleting it.
+
+## Where it applies
+
+Pick the scope when you add a server:
+
+- **personal** — available in every project
+- **project** — available only in the current project, and saved alongside the project's other settings
+
+Server names use lowercase letters, numbers, hyphens, and underscores.
+
+## Related
+
+- [Providers, Models & Agents](/providers/) — connect a model first
+- [Skills](/skills/) — another way to extend what agents can do

packages/docs/content/docs/mobile.mdx

@@ -0,0 +1,31 @@
+---
+title: PWA & Mobile Access
+description: Install OpenChamber as an app and use it from your phone.
+---
+
+# PWA & Mobile Access
+
+The OpenChamber web app installs like a phone app (a PWA), so you can keep it on your home screen and use it full-screen. Pair it with a [tunnel](/tunnels/) and you can check in on a session from anywhere.
+
+## Install it
+
+OpenChamber uses your browser's built-in install, so there's no separate download:
+
+- **desktop browser** — use the **Install** option in the address bar
+- **iPhone/iPad (Safari)** — Share → **Add to Home Screen**
+- **Android (Chrome)** — menu → **Install app** / **Add to Home Screen**
+
+Once installed, it opens in its own window without browser chrome.
+
+## Reach it from your phone
+
+To open OpenChamber on your phone when the server runs on your computer, start a [tunnel](/tunnels/) and open the link (or scan the QR code) on the phone. Use a strong [UI password](/security/) whenever you do this.
+
+## Mobile settings
+
+Under **Settings → OpenChamber**, a few options tune the mobile and installed experience — the app's installed name, screen orientation, and how the on-screen keyboard behaves.
+
+## Related
+
+- [Tunnels](/tunnels/) — reach your instance from another network
+- [Security](/security/) — protect the UI before exposing it

packages/docs/content/docs/multi-run.mdx

@@ -0,0 +1,34 @@
+---
+title: Multi-run
+description: Run the same prompt across several models or sessions at once.
+---
+
+# Multi-run
+
+Multi-run launches several sessions from one form — handy for trying the same task with different models and comparing the results. Open it from the button at the top of the session sidebar.
+
+## Start a multi-run
+
+1. Open the multi-run launcher.
+2. Pick the project and name the run group.
+3. Write the prompt and pick the models to run it with (up to five per group).
+4. Choose whether to **isolate runs**.
+5. Launch.
+
+Each model gets its own session, and they all start with your prompt.
+
+## Isolated runs
+
+Turn on **isolate runs** to give every run its own [worktree](/worktrees/) and branch, so they never touch the same files. This needs a git repo — it's turned off automatically for folders that aren't one. Pick the branch the runs start from.
+
+With isolation off, every run is a plain session in the project folder.
+
+## Comparing results
+
+Each run is a normal session you can open, read, and keep or discard. If you started runs to compare approaches, review them side by side and carry the best one forward.
+
+If a single run fails to start, the others still launch — you'll just see fewer sessions than you asked for.
+
+## Related
+
+- [Worktree Sessions](/worktrees/) — how isolation works under the hood

packages/docs/content/docs/notes-todos-plans.mdx

@@ -0,0 +1,37 @@
+---
+title: Project Notes, Todos & Plans
+description: Keep notes, a todo list, and saved plans for each project.
+---
+
+# Project Notes, Todos & Plans
+
+Each project has its own scratch space for notes, a todo list, and saved plans. They belong to the project, not to any one session, so they stick around as you move between sessions. Find them in the **Context** tab of the right sidebar (a dedicated tab on mobile).
+
+## Notes
+
+A free-form notes box for anything you want to remember about the project. It saves on its own as you type.
+
+## Todos
+
+A simple checklist. Add items, check them off, reorder them by dragging, and clear the finished ones.
+
+Each todo has a **send** menu so you can hand it to the agent:
+
+- send it to the current session
+- start a new session with it
+- start a new [worktree session](/worktrees/) with it (only when the project is a git repo)
+
+## Plans
+
+A place to keep longer plans as saved files. You can:
+
+- import a plan from a Markdown or text file
+- open a plan to read it in the side panel
+- delete plans you no longer need
+
+You should land back in the Context tab with your note saved, your todo checked, or your plan listed — that's how you know it took.
+
+## Related
+
+- [Worktree Sessions](/worktrees/) — run a todo in its own branch
+- [Projects](/projects/) — these belong to the active project

packages/docs/content/docs/notifications.mdx

@@ -0,0 +1,34 @@
+---
+title: Notifications
+description: Get told when a session needs you or finishes.
+---
+
+# Notifications
+
+Notifications tell you when something needs your attention so you don't have to watch the screen — a session finished, hit an error, asked a question, or needs permission to do something. Set them up at **Settings → OpenChamber → Notifications**.
+
+## Turn them on
+
+1. Open **Settings → OpenChamber → Notifications**.
+2. Allow notifications when your browser or system asks.
+3. Choose what you want to be told about:
+   - a session **finishes**
+   - a session hits an **error**
+   - a session **asks a question**
+   - a session needs **permission**
+   - **subtasks** complete
+
+## How they reach you
+
+- on **desktop**, you get native system notifications
+- in a **browser or installed app**, you get web push notifications, so they arrive even when the tab is in the background
+
+Sessions set to auto-accept won't nag you with permission notifications.
+
+## Customize the wording
+
+Each kind of notification has a title and message template you can edit, using fields like the agent name and model. There's also a limit on how much of the last message is included, so notifications stay short.
+
+## Related
+
+- [Voice Mode](/voice/) — hear replies read aloud instead

packages/docs/content/docs/opencode-server.mdx

@@ -0,0 +1,54 @@
+---
+title: OpenCode Server
+description: Connect OpenChamber to a local or remote OpenCode server.
+---
+
+# OpenCode Server
+
+OpenChamber runs on top of an OpenCode server. By default it starts one for you, so you don't have to do anything. You only need this page if you want to point OpenChamber at a server you already run, or manage the one it starts.
+
+## How OpenChamber finds a server
+
+When OpenChamber starts, it looks for a server in this order:
+
+1. reuse a server it already started
+2. connect to an external one if you told it to (see below)
+3. auto-detect a server on the default port (`4096`)
+4. otherwise, start and manage its own
+
+If nothing is configured, step 4 happens automatically and you're up and running.
+
+## Connect to a server you already run
+
+Set these before starting OpenChamber:
+
+```bash
+OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber
+```
+
+- `OPENCODE_HOST` — the full address of your OpenCode server, including the port (a value like `http://localhost:4096`). It must not have a path at the end.
+- `OPENCODE_SKIP_START=true` — tells OpenChamber not to start its own server.
+
+If you only need to change the port, set `OPENCODE_PORT` instead of `OPENCODE_HOST`.
+
+If `OPENCODE_HOST` is missing its port or has a path, OpenChamber ignores it and falls back to starting its own server. Watch the startup logs for a `[config]` warning if a connection you expected didn't happen.
+
+## Manage the server from the CLI
+
+```bash
+openchamber status
+openchamber logs
+openchamber restart
+openchamber stop
+```
+
+`openchamber` on its own starts the server in the background. Add `--foreground` to keep it attached to your terminal.
+
+## "OpenCode is restarting"
+
+While the server is starting or restarting, OpenChamber shows an "OpenCode is restarting" state and pauses requests until it's ready. This is normal right after launch or a restart. If it never clears, see [OpenCode connection](/troubleshooting/opencode-connection/).
+
+## Related
+
+- [Providers, Models & Agents](/providers/) — set up what the server talks to
+- [OpenCode connection](/troubleshooting/opencode-connection/) — if it won't connect

packages/docs/content/docs/pl/commands-snippets.mdx

@@ -0,0 +1,39 @@
+---
+title: Polecenia i fragmenty
+description: Twórz wielokrotnego użytku polecenia z ukośnikiem i fragmenty tekstu do czatu.
+---
+
+# Polecenia i fragmenty
+
+Polecenia i fragmenty oszczędzają Ci ponownego wpisywania tego samego. Polecenia to całe prompty uruchamiane przez `/`; fragmenty to kawałki tekstu wstawiane do wiadomości przez `#`.
+
+## Polecenia
+
+Polecenie to zapisany prompt uruchamiany ukośnikiem, jak `/review`. Zarządzaj nimi w **Settings → Commands**.
+
+1. Otwórz **Settings → Commands** i utwórz polecenie.
+2. Nadaj mu nazwę, opis i tekst promptu, który ma wysłać.
+3. Opcjonalnie przypnij je do konkretnego agenta lub modelu.
+4. Wybierz zakres osobisty lub projektowy.
+
+W czacie wpisz `/` jako **pierwszy** znak wiadomości, aby otworzyć polecenia, a następnie wybierz jedno. Twój tekst może używać symboli zastępczych:
+
+- `$ARGUMENTS` — to, co wpiszesz po poleceniu
+- `@filename` — wstawia zawartość pliku
+- `` !`command` `` — wstawia wynik polecenia powłoki
+
+Wbudowane polecenia `init` i `review` można zresetować, ale nie usunąć.
+
+## Fragmenty
+
+Fragment to wielokrotnego użytku tekst, do którego odwołujesz się w treści hasztagiem, jak `#signoff`. Zarządzaj nimi w **Settings → Snippets**.
+
+1. Otwórz **Settings → Snippets** i utwórz fragment.
+2. Nadaj mu nazwę i tekst, który reprezentuje. Dodaj aliasy, jeśli chcesz mieć więcej niż jeden wyzwalacz.
+3. Wybierz zakres osobisty lub projektowy.
+
+W czacie wpisz `#` i wybierz fragment. OpenChamber podstawi pełny tekst przed wysłaniem.
+
+## Powiązane
+
+- [Skille](/pl/skills/) — wczytuj większe zestawy instrukcji na żądanie

packages/docs/content/docs/pl/context.mdx

@@ -0,0 +1,38 @@
+---
+title: Kontekst
+description: Zobacz, ile pamięci modelu zużywa sesja.
+---
+
+# Kontekst
+
+Każdy model może pomieścić naraz tylko określoną część rozmowy — swój kontekst. OpenChamber pokazuje, jak bardzo jest on zapełniony, dzięki czemu widzisz, kiedy sesja zbliża się do limitu i odpowiedź może zacząć pomijać starsze szczegóły.
+
+## Szybki wskaźnik
+
+Podczas czatu mały wskaźnik pokazuje procent wykorzystanego kontekstu. Zmienia kolor w miarę zapełniania:
+
+- zielony — dużo miejsca
+- żółty — coraz pełniej (około trzech czwartych)
+- czerwony — niemal pełny
+
+Najedź na niego (lub stuknij na telefonie), aby zobaczyć dokładną liczbę tokenów.
+
+## Pełny panel kontekstu
+
+Otwórz zakładkę **Context** w prawym pasku bocznym, aby zobaczyć pełniejszy obraz bieżącej sesji:
+
+- używany model i kiedy sesja się rozpoczęła
+- łączna liczba tokenów względem limitu modelu
+- sumy wiadomości i kosztów
+- podział tokenów ostatniej odpowiedzi
+- przybliżony podział tego, co zajmuje kontekst (Twoje wiadomości, agenta, wynik narzędzi)
+
+Podział jest szacunkiem, a nie dokładnym wyliczeniem — używaj go do wykrycia, co zapełnia okno, a nie do rozliczeń.
+
+## Co zrobić, gdy jest pełny
+
+Rozpocznij świeżą sesję dla nowego zadania, zamiast pozwalać jednej sesji rosnąć w nieskończoność. Krótszy kontekst jest szybszy i utrzymuje model skupionym.
+
+## Powiązane
+
+- [Projekty](/pl/projects/) — sesje są grupowane według projektu

packages/docs/content/docs/pl/desktop-browser.mdx

@@ -0,0 +1,22 @@
+---
+title: Przeglądarka na komputerze
+description: Przeglądaj dowolną stronę wewnątrz aplikacji na komputerze, z inspekcją i przechwytywaniem konsoli.
+---
+
+# Przeglądarka na komputerze
+
+Aplikacja na komputerze ma wbudowaną przeglądarkę, dzięki czemu możesz otworzyć dowolną stronę tuż obok czatu, wskazywać elementy, aby o nie zapytać, oraz przechwytywać konsolę strony. Otwórz ją z przycisku globusa w nagłówku aplikacji.
+
+> Przeglądarka na komputerze to funkcja **tylko na komputerze**. W wersji webowej panel [podglądu](/pl/preview/) oferuje te same narzędzia inspekcji i konsoli dla Twojego lokalnego serwera deweloperskiego.
+
+## Inspekcja i adnotacje
+
+Włącz **inspect** i kliknij dowolny element na stronie. OpenChamber przechwytuje o nim notatkę — czym jest, jakie ma style, gdzie się znajduje, oraz zrzut ekranu — i dołącza ją do Twojej wiadomości czatu. To najszybszy sposób, by powiedzieć agentowi „ten element, dokładnie tutaj”.
+
+## Przechwytywanie konsoli
+
+Przeglądarka zbiera wynik konsoli strony — błędy, ostrzeżenia i logi — dzięki czemu możesz go filtrować i czytać bez otwierania narzędzi deweloperskich.
+
+## Powiązane
+
+- [Podgląd i serwery deweloperskie](/pl/preview/) — te same narzędzia dla Twojego lokalnego serwera deweloperskiego

packages/docs/content/docs/pl/git-identities.mdx

@@ -0,0 +1,30 @@
+---
+title: Tożsamości Git
+description: Commituj z właściwym imieniem i adresem e-mail dla każdego repozytorium.
+---
+
+# Tożsamości Git
+
+Tożsamość git to imię i adres e-mail, którymi podpisywane są Twoje commity. Jeśli pracujesz z repozytoriami osobistymi i służbowymi, możesz zapisać tożsamości i zastosować właściwą dla każdego repozytorium, zamiast polegać na jednym globalnym ustawieniu. Zarządzaj nimi w **Settings → Git**.
+
+## Dodaj tożsamość
+
+1. Otwórz **Settings → Git** i wybierz **New**.
+2. Wprowadź **name** i **email**, którymi chcesz commitować.
+3. Wybierz, jak uwierzytelnia się ze zdalnym repozytorium:
+   - **SSH** — wskaż klucz SSH
+   - **token** — użyj zapisanego poświadczenia dla hosta
+4. Opcjonalnie nadaj jej kolor i ikonę, by łatwo było ją rozpoznać.
+
+Globalna tożsamość Twojego systemu również jest pokazana, tylko do odczytu.
+
+## Zastosuj tożsamość do repozytorium
+
+Zastosowanie tożsamości zapisuje ją do **lokalnej** konfiguracji git tego repozytorium — wpływa tylko na to repozytorium, a nie na Twoje ustawienie globalne. Tożsamości SSH ustawiają też polecenie SSH, aby używać Twojego klucza; tożsamości tokenowe konfigurują przechowywanie poświadczeń dla hosta.
+
+Możesz zaimportować tożsamości, które OpenChamber wykryje w Twoich istniejących poświadczeniach git, i zapisać je jako tożsamości tokenowe.
+
+## Powiązane
+
+- [Przepływy Git i GitHub](/pl/git/) — commituj, używając ustawionej tożsamości
+- [Issues i PR na GitHub](/pl/github/) — połącz konto GitHub na potrzeby PR-ów

packages/docs/content/docs/pl/git.mdx

@@ -0,0 +1,41 @@
+---
+title: Przepływy Git i GitHub
+description: Dodawaj do indeksu, commituj i zarządzaj gałęziami bez wychodzenia z OpenChamber.
+---
+
+# Przepływy Git i GitHub
+
+OpenChamber ma wbudowany widok git, dzięki czemu możesz przeglądać zmiany, commitować i zarządzać gałęziami bez przełączania się na terminal. Otwórz go z zakładki **Git** w prawym pasku bocznym.
+
+## Przeglądaj i commituj
+
+Widok git dzieli Twoje zmiany na **staged** i **unstaged**:
+
+- kliknij **+** przy pliku, aby dodać go do indeksu, lub **−**, aby go usunąć z indeksu
+- dodaj lub usuń z indeksu wszystko w grupie naraz
+- kliknij plik, aby zobaczyć jego diff
+
+Następnie napisz komunikat commita i commituj. Możesz zlecić OpenChamber **wygenerowanie komunikatu commita** na podstawie Twoich zmian z indeksu — używa modelu bieżącej sesji, więc potrzebujesz otwartej sesji.
+
+## Gałęzie i historia
+
+Widok git obejmuje też resztę codziennej pracy z git:
+
+- twórz, przełączaj, zmieniaj nazwy i usuwaj gałęzie
+- push, pull i fetch
+- przeglądaj historię i diffy poszczególnych commitów
+- odkładaj (stash) i przywracaj zmiany
+
+## Pull requesty
+
+Połącz GitHub (zobacz [Issues i PR na GitHub](/pl/github/)), a zakładka **PR** pozwoli Ci otworzyć pull request, zaktualizować go, oznaczyć jako gotowy lub scalić — oraz wygenerować jego tytuł i opis w ten sam sposób co komunikaty commitów.
+
+## Rozwiązywanie konfliktów
+
+Jeśli scalanie, rebase lub integracja napotka konflikt, OpenChamber pokazuje, co utknęło, i pozwala Ci to rozwiązać — w tym przekazać to agentowi.
+
+## Powiązane
+
+- [Issues i PR na GitHub](/pl/github/) — połącz GitHub i rozpocznij pracę od issue
+- [Sesje worktree](/pl/worktrees/) — izoluj gałąź w jej własnym folderze
+- [Tożsamości Git](/pl/git-identities/) — commituj jako właściwa osoba w każdym repozytorium

packages/docs/content/docs/pl/github.mdx

@@ -0,0 +1,34 @@
+---
+title: Issues i PR na GitHub
+description: Połącz GitHub i rozpoczynaj sesje od issues i pull requestów.
+---
+
+# Issues i PR na GitHub
+
+Połącz swoje konto GitHub, a OpenChamber może pobierać issues i pull requesty, rozpocząć sesję bezpośrednio z jednego z nich oraz otwierać lub aktualizować za Ciebie PR-y.
+
+## Połącz GitHub
+
+1. Otwórz **Settings → Git**.
+2. W sekcji GitHub wybierz **Connect**. OpenChamber pokazuje link i krótki kod.
+3. Otwórz link, wpisz kod i zatwierdź.
+
+Po połączeniu Twoje konto pojawia się w sekcji GitHub. Możesz połączyć więcej niż jedno konto i przełączać się między nimi albo rozłączyć w dowolnym momencie.
+
+## Rozpocznij pracę od issue lub PR
+
+Gdy tworzysz [sesję worktree](/pl/worktrees/) z połączonym GitHub, możesz wybrać **Start from GitHub issue/PR**:
+
+- wybierz **issue**, a OpenChamber nazwie gałąź jego nazwą i otworzy sesję z issue oraz jego komentarzami jako pierwszą wiadomością
+- wybierz **pull request**, a wyewidencjonuje on gałąź PR; możesz dołączyć diff PR, aby agent miał całą zmianę
+
+To wprowadza Cię prosto do sesji z już wczytanym kontekstem.
+
+## Otwieraj pull requesty i nimi zarządzaj
+
+Z zakładki **PR** w [widoku git](/pl/git/) możesz utworzyć pull request, zaktualizować go, oznaczyć szkic jako gotowy lub scalić go. OpenChamber może wygenerować tytuł i opis PR na podstawie Twoich zmian.
+
+## Powiązane
+
+- [Przepływy Git i GitHub](/pl/git/) — commituj i zarządzaj gałęziami
+- [Sesje worktree](/pl/worktrees/) — gdzie startują sesje issue i PR

packages/docs/content/docs/pl/index.mdx

@@ -20,6 +20,13 @@ Skorzystaj z tej dokumentacji, aby:
 - [Tunele](/pl/tunnels/)
 - [Rozwiązywanie problemów](/pl/troubleshooting/)
 
+## Odkryj więcej
+
+- [Projekty](/pl/projects/) i [Sesje worktree](/pl/worktrees/) — organizuj i izoluj swoją pracę
+- [Dostawcy, modele i agenci](/pl/providers/) — połącz OpenCode i wybierz model
+- [Przepływy Git i GitHub](/pl/git/) — twórz commity, przeglądaj i otwieraj PR-y
+- [Bezpieczeństwo](/pl/security/) i [Tunele](/pl/tunnels/) — chroń swoją instancję i uzyskuj do niej dostęp
+
 ## Do czego służy OpenChamber
 
 OpenChamber jest przeznaczony do tych części programowania z AI, które zyskują na centrum dowodzenia: rozgałęzianie sesji, przeglądanie diffów, zarządzanie terminalami, śledzenie postępu narzędzi, uruchamianie akcji projektu i utrzymywanie całej planszy na widoku, gdy agent pracuje.

packages/docs/content/docs/pl/magic-prompts.mdx

@@ -0,0 +1,26 @@
+---
+title: Magic Prompts
+description: Dostosuj wbudowane prompty stojące za automatycznymi przepływami OpenChamber.
+---
+
+# Magic Prompts
+
+OpenChamber używa w tle wbudowanych promptów za każdym razem, gdy robi coś automatycznie — pisze komunikat commita, szkicuje PR, przegląda issue, rozwiązuje konflikt, podsumowuje sesję. Magic Prompts to miejsce, w którym czytasz i przepisujesz te prompty. Otwórz je w **Settings → Magic Prompts**.
+
+Do normalnego użytku ta strona nie jest potrzebna. Sięgnij po nią, gdy chcesz, by przepływ zachowywał się inaczej — powiedzmy komunikaty commitów w określonym stylu.
+
+## Edytuj prompt
+
+1. Otwórz **Settings → Magic Prompts**.
+2. Wybierz prompt z grup w pasku bocznym — Git, GitHub, Planning i Session.
+3. Edytuj tekst i zapisz.
+
+Niektóre prompty mają część widoczną (wiadomość, którą zobaczysz) i część z instrukcjami (ukryte wskazówki dla agenta). Prompty mogą zawierać `{{placeholders}}`, które OpenChamber uzupełnia, jak diff czy tytuł issue — zostaw je na miejscu.
+
+## Reset
+
+Zmieniłeś zdanie? Każdy prompt ma **reset to default**, a jest też **reset all**, jeśli chcesz zacząć wszystko od nowa.
+
+## Powiązane
+
+- [Przepływy Git i GitHub](/pl/git/) — wiele z tych promptów napędza przepływy git

packages/docs/content/docs/pl/mcp.mdx

@@ -0,0 +1,30 @@
+---
+title: Serwery MCP
+description: Dodawaj serwery MCP, aby dać agentom dodatkowe narzędzia.
+---
+
+# Serwery MCP
+
+Serwer MCP daje Twoim agentom dodatkowe narzędzia — takie jak przeszukiwanie bazy danych, wywoływanie API czy odczytywanie używanej przez Ciebie usługi. Dodaj je w **Settings → MCP**.
+
+## Dodaj serwer
+
+1. Otwórz **Settings → MCP**.
+2. Dodaj serwer i wybierz jego typ:
+   - **local** — OpenChamber uruchamia polecenie na Twojej maszynie. Podajesz polecenie do uruchomienia oraz, w razie potrzeby, zmienne środowiskowe.
+   - **remote** — OpenChamber łączy się z adresem URL hostowanym przez kogoś innego. Podajesz adres URL oraz wszelkie potrzebne nagłówki (na przykład token uwierzytelniający).
+3. Zapisz. Serwer jest domyślnie włączony; możesz go wyłączyć bez usuwania.
+
+## Gdzie obowiązuje
+
+Wybierz zakres przy dodawaniu serwera:
+
+- **personal** — dostępny w każdym projekcie
+- **project** — dostępny tylko w bieżącym projekcie i zapisany razem z pozostałymi ustawieniami projektu
+
+Nazwy serwerów używają małych liter, cyfr, myślników i podkreśleń.
+
+## Powiązane
+
+- [Dostawcy, modele i agenci](/pl/providers/) — najpierw połącz model
+- [Skille](/pl/skills/) — inny sposób na rozszerzenie możliwości agentów

packages/docs/content/docs/pl/mobile.mdx

@@ -0,0 +1,31 @@
+---
+title: PWA i dostęp z telefonu
+description: Zainstaluj OpenChamber jako aplikację i używaj go z telefonu.
+---
+
+# PWA i dostęp z telefonu
+
+Aplikacja webowa OpenChamber instaluje się jak aplikacja na telefonie (PWA), więc możesz trzymać ją na ekranie głównym i używać jej na pełnym ekranie. Połącz to z [tunelem](/pl/tunnels/), a będziesz mógł zajrzeć do sesji z dowolnego miejsca.
+
+## Zainstaluj ją
+
+OpenChamber korzysta z wbudowanej instalacji Twojej przeglądarki, więc nie ma osobnego pobierania:
+
+- **przeglądarka na komputerze** — użyj opcji **Install** w pasku adresu
+- **iPhone/iPad (Safari)** — Udostępnij → **Dodaj do ekranu początkowego**
+- **Android (Chrome)** — menu → **Zainstaluj aplikację** / **Dodaj do ekranu głównego**
+
+Po zainstalowaniu otwiera się we własnym oknie, bez elementów przeglądarki.
+
+## Dotrzyj do niej z telefonu
+
+Aby otworzyć OpenChamber na telefonie, gdy serwer działa na Twoim komputerze, uruchom [tunel](/pl/tunnels/) i otwórz link (lub zeskanuj kod QR) na telefonie. Używaj silnego [hasła UI](/pl/security/), gdy tylko to robisz.
+
+## Ustawienia mobilne
+
+W **Settings → OpenChamber** kilka opcji dostraja działanie na telefonie i zainstalowanej aplikacji — nazwę zainstalowanej aplikacji, orientację ekranu i zachowanie klawiatury ekranowej.
+
+## Powiązane
+
+- [Tunele](/pl/tunnels/) — dotrzyj do swojej instancji z innej sieci
+- [Bezpieczeństwo](/pl/security/) — zabezpiecz UI przed udostępnieniem

packages/docs/content/docs/pl/multi-run.mdx

@@ -0,0 +1,32 @@
+---
+title: Multi-run
+description: Uruchom ten sam prompt na kilku modelach lub w kilku sesjach naraz.
+---
+
+# Multi-run
+
+Multi-run uruchamia kilka sesji z jednego formularza — przydatne do wypróbowania tego samego zadania na różnych modelach i porównania wyników. Otwórz go z przycisku u góry paska bocznego sesji.
+
+## Rozpocznij multi-run
+
+1. Otwórz launcher multi-run.
+2. Wybierz projekt i nazwij grupę uruchomień.
+3. Napisz prompt i wybierz modele, na których ma się uruchomić (do pięciu na grupę).
+4. Wybierz, czy **isolate runs**.
+5. Uruchom.
+
+Każdy model dostaje własną sesję i wszystkie startują z Twoim promptem.
+
+## Izolowane uruchomienia
+
+Włącz **isolate runs**, aby każde uruchomienie miało własny [worktree](/pl/worktrees/) i gałąź, dzięki czemu nigdy nie dotykają tych samych plików. Wymaga to repozytorium git — dla folderów, które nim nie są, jest automatycznie wyłączone. Wybierz gałąź, od której startują uruchomienia.
+
+Gdy izolacja jest wyłączona, każde uruchomienie jest zwykłą sesją w folderze projektu.
+
+## Porównywanie wyników
+
+Każde uruchomienie to zwykła sesja, którą możesz otworzyć, przeczytać i zachować lub odrzucić. Jeśli uruchomiłeś sesje, aby porównać podejścia, przejrzyj je obok siebie i przenieś najlepsze dalej.
+
+## Powiązane
+
+- [Sesje worktree](/pl/worktrees/) — jak izolacja działa pod spodem

packages/docs/content/docs/pl/notes-todos-plans.mdx

@@ -0,0 +1,37 @@
+---
+title: Notatki, listy zadań i plany projektu
+description: Prowadź notatki, listę zadań i zapisane plany dla każdego projektu.
+---
+
+# Notatki, listy zadań i plany projektu
+
+Każdy projekt ma własną przestrzeń roboczą na notatki, listę zadań i zapisane plany. Należą do projektu, a nie do żadnej pojedynczej sesji, więc pozostają na miejscu, gdy przechodzisz między sesjami. Znajdziesz je w zakładce **Context** prawego paska bocznego (na telefonie dedykowana zakładka).
+
+## Notatki
+
+Dowolne pole na notatki o wszystkim, co chcesz zapamiętać na temat projektu. Zapisuje się samo w trakcie pisania.
+
+## Listy zadań
+
+Prosta lista kontrolna. Dodawaj pozycje, odhaczaj je, zmieniaj kolejność przeciąganiem i czyść ukończone.
+
+Każde zadanie ma menu **send**, dzięki któremu możesz przekazać je agentowi:
+
+- wyślij je do bieżącej sesji
+- rozpocznij z nim nową sesję
+- rozpocznij z nim nową [sesję worktree](/pl/worktrees/) (tylko gdy projekt jest repozytorium git)
+
+## Plany
+
+Miejsce na przechowywanie dłuższych planów jako zapisanych plików. Możesz:
+
+- zaimportować plan z pliku Markdown lub tekstowego
+- otworzyć plan, aby przeczytać go w panelu bocznym
+- usunąć plany, których już nie potrzebujesz
+
+Powinieneś wrócić do zakładki Context z zapisaną notatką, odhaczonym zadaniem lub wylistowanym planem — tak poznasz, że się udało.
+
+## Powiązane
+
+- [Sesje worktree](/pl/worktrees/) — uruchom zadanie w jego własnej gałęzi
+- [Projekty](/pl/projects/) — należą one do aktywnego projektu

packages/docs/content/docs/pl/notifications.mdx

@@ -0,0 +1,34 @@
+---
+title: Powiadomienia
+description: Otrzymuj powiadomienia, gdy sesja Cię potrzebuje lub kończy pracę.
+---
+
+# Powiadomienia
+
+Powiadomienia informują Cię, gdy coś wymaga Twojej uwagi, dzięki czemu nie musisz wpatrywać się w ekran — sesja się zakończyła, napotkała błąd, zadała pytanie albo potrzebuje uprawnień do zrobienia czegoś. Skonfiguruj je w **Settings → OpenChamber → Notifications**.
+
+## Włącz je
+
+1. Otwórz **Settings → OpenChamber → Notifications**.
+2. Zezwól na powiadomienia, gdy przeglądarka lub system o to poprosi.
+3. Wybierz, o czym chcesz być informowany:
+   - sesja się **kończy**
+   - sesja napotyka **błąd**
+   - sesja **zadaje pytanie**
+   - sesja potrzebuje **uprawnień**
+   - **podzadania** się kończą
+
+## Jak do Ciebie docierają
+
+- na **komputerze** otrzymujesz natywne powiadomienia systemowe
+- w **przeglądarce lub zainstalowanej aplikacji** otrzymujesz powiadomienia web push, więc docierają nawet wtedy, gdy karta jest w tle
+
+Sesje ustawione na automatyczną akceptację nie będą Cię nagabywać powiadomieniami o uprawnieniach.
+
+## Dostosuj treść
+
+Każdy rodzaj powiadomienia ma szablon tytułu i wiadomości, który możesz edytować, używając pól takich jak nazwa agenta i model. Jest też limit tego, ile z ostatniej wiadomości zostaje dołączone, aby powiadomienia pozostały krótkie.
+
+## Powiązane
+
+- [Tryb głosowy](/pl/voice/) — zamiast tego słuchaj odczytywanych odpowiedzi

packages/docs/content/docs/pl/opencode-server.mdx

@@ -0,0 +1,54 @@
+---
+title: OpenCode Server
+description: Połącz OpenChamber z lokalnym lub zdalnym serwerem OpenCode.
+---
+
+# OpenCode Server
+
+OpenChamber działa na bazie serwera OpenCode. Domyślnie uruchamia go za Ciebie, więc nie musisz robić nic dodatkowego. Ta strona jest potrzebna tylko wtedy, gdy chcesz wskazać OpenChamber serwer, który już uruchamiasz, albo zarządzać tym, który sam startuje.
+
+## Jak OpenChamber znajduje serwer
+
+Gdy OpenChamber się uruchamia, szuka serwera w tej kolejności:
+
+1. ponownie używa serwera, który już uruchomił
+2. łączy się z zewnętrznym, jeśli mu to wskazałeś (zobacz niżej)
+3. automatycznie wykrywa serwer na domyślnym porcie (`4096`)
+4. w przeciwnym razie uruchamia i obsługuje własny
+
+Jeśli nic nie jest skonfigurowane, krok 4 dzieje się automatycznie i od razu możesz pracować.
+
+## Połącz się z serwerem, który już uruchamiasz
+
+Ustaw te wartości przed uruchomieniem OpenChamber:
+
+```bash
+OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber
+```
+
+- `OPENCODE_HOST` — pełny adres Twojego serwera OpenCode, wraz z portem (wartość taka jak `http://localhost:4096`). Nie może zawierać ścieżki na końcu.
+- `OPENCODE_SKIP_START=true` — informuje OpenChamber, aby nie uruchamiał własnego serwera.
+
+Jeśli chcesz zmienić tylko port, ustaw `OPENCODE_PORT` zamiast `OPENCODE_HOST`.
+
+Jeśli w `OPENCODE_HOST` brakuje portu lub zawiera ścieżkę, OpenChamber go zignoruje i wróci do uruchamiania własnego serwera. Obserwuj logi startowe pod kątem ostrzeżenia `[config]`, jeśli oczekiwane połączenie nie nastąpiło.
+
+## Zarządzaj serwerem z poziomu CLI
+
+```bash
+openchamber status
+openchamber logs
+openchamber restart
+openchamber stop
+```
+
+Samo `openchamber` uruchamia serwer w tle. Dodaj `--foreground`, aby pozostał dołączony do Twojego terminala.
+
+## „OpenCode uruchamia się ponownie”
+
+Gdy serwer startuje lub uruchamia się ponownie, OpenChamber pokazuje stan „OpenCode uruchamia się ponownie” i wstrzymuje żądania, aż będzie gotowy. To normalne tuż po uruchomieniu lub restarcie. Jeśli ten stan nigdy nie znika, zobacz [Połączenie z OpenCode](/pl/troubleshooting/opencode-connection/).
+
+## Powiązane
+
+- [Dostawcy, modele i agenci](/pl/providers/) — skonfiguruj to, z czym serwer się komunikuje
+- [Połączenie z OpenCode](/pl/troubleshooting/opencode-connection/) — jeśli nie chce się połączyć

packages/docs/content/docs/pl/preview.mdx

@@ -0,0 +1,32 @@
+---
+title: Podgląd i serwery deweloperskie
+description: Otwórz działający serwer deweloperski wewnątrz OpenChamber.
+---
+
+# Podgląd i serwery deweloperskie
+
+Gdy uruchamiasz serwer deweloperski, OpenChamber może otworzyć go bezpośrednio w aplikacji zamiast w osobnej karcie przeglądarki — dzięki czemu widzisz swoją witrynę obok czatu, przechwytujesz jej konsolę i wskazujesz elementy, aby o nie zapytać.
+
+## Otwórz podgląd
+
+OpenChamber obserwuje wynik terminala pod kątem adresu lokalnego (wiersz `Local:`, który drukują narzędzia takie jak Vite, Next.js czy Astro). Gdy go wykryje:
+
+- w terminalu pojawia się przycisk **Open preview**
+- [akcja projektu](/pl/project-actions/) z włączonym auto-open otwiera go za Ciebie
+- lokalny link w wiadomości czatu również może go otworzyć
+
+Witryna ładuje się w panelu bocznym. Podglądać można wyłącznie adresy lokalne (na Twojej własnej maszynie).
+
+## Konsola i inspekcja
+
+W panelu podglądu możesz:
+
+- obserwować **konsolę** strony — błędy, ostrzeżenia i logi, filtrowane wedle uznania
+- włączyć **inspect**, kliknąć dowolny element i wysłać o nim notatkę — selektor, style, pozycję i zrzut ekranu — prosto do czatu
+
+To najszybszy sposób, by powiedzieć agentowi „ten przycisk, tutaj”, bez opisywania go.
+
+## Powiązane
+
+- [Akcje projektu](/pl/project-actions/) — automatycznie otwórz serwer przy uruchomieniu
+- [Przeglądarka na komputerze](/pl/desktop-browser/) — te same narzędzia dla dowolnej strony, na komputerze

packages/docs/content/docs/pl/project-actions.mdx

@@ -0,0 +1,28 @@
+---
+title: Akcje projektu
+description: Zapisuj często uruchamiane polecenia i uruchamiaj je jednym kliknięciem.
+---
+
+# Akcje projektu
+
+Akcja projektu to polecenie powłoki, które zapisujesz raz i uruchamiasz kliknięciem — serwer deweloperski, build, uruchomienie testów. Każdy projekt ma własną listę. Skonfiguruj je w **Settings → Projects → Project Actions**.
+
+## Dodaj akcję
+
+1. Otwórz **Settings → Projects** i znajdź sekcję **Project Actions**.
+2. Dodaj akcję, nadaj jej nazwę, wybierz ikonę i wprowadź polecenie do uruchomienia.
+3. Zapisz.
+
+Akcję możesz ograniczyć do określonych systemów operacyjnych, jeśli polecenie ma sens tylko na jednym z nich.
+
+## Uruchom akcję
+
+Akcje znajdują się w menu w nagłówku aplikacji. Kliknij jedną, a OpenChamber uruchomi ją w terminalu w folderze Twojego projektu, przełączając Cię na widok terminala, byś mógł obserwować wynik. Zatrzymaj ją z tego samego menu.
+
+## Automatyczne otwieranie serwera deweloperskiego
+
+Włącz **auto-open URL** dla akcji, która uruchamia serwer. OpenChamber obserwuje wynik pod kątem adresu lokalnego i proponuje jego otwarcie — zobacz [Podgląd i serwery deweloperskie](/pl/preview/). Na komputerze możesz też przekierować go przez przekazywanie portu SSH.
+
+## Powiązane
+
+- [Podgląd i serwery deweloperskie](/pl/preview/) — otwórz działający serwer deweloperski wewnątrz OpenChamber

packages/docs/content/docs/pl/project-icons.mdx

@@ -0,0 +1,20 @@
+---
+title: Ikony projektów
+description: Nadaj każdemu projektowi rozpoznawalną ikonę.
+---
+
+# Ikony projektów
+
+Ikona projektu ułatwia odróżnienie projektów na pierwszy rzut oka. OpenChamber próbuje znaleźć jedną za Ciebie, a Ty zawsze możesz ustawić własną. Zarządzaj nią w **Settings → Projects**.
+
+## Automatyczne wykrywanie
+
+Gdy dodajesz projekt, OpenChamber szuka w nim pliku `favicon` i używa go jako ikony projektu. Jeśli Twoje repozytorium już zawiera favicon, ikona zwykle po prostu się pojawia — nic nie trzeba robić.
+
+## Ustaw własną
+
+Otwórz **Settings → Projects** i prześlij obraz (PNG, JPEG lub SVG, do 5 MB). Własny obraz ma pierwszeństwo przed wykrytym automatycznie. Możesz też wybrać kolor albo usunąć obraz, aby wrócić do wykrywania.
+
+## Powiązane
+
+- [Projekty](/pl/projects/) — nazywaj, koloruj i organizuj swoje projekty

packages/docs/content/docs/pl/projects.mdx

@@ -0,0 +1,34 @@
+---
+title: Projekty
+description: Organizuj swoją pracę w projekty i przełączaj się między nimi.
+---
+
+# Projekty
+
+Projekt to folder na Twoim komputerze, który OpenChamber śledzi — zwykle jedna baza kodu. Przełączenie projektu zmienia folder, w którym pracuje agent, wraz z sesjami i ustawieniami tego projektu.
+
+## Dodaj projekt
+
+Projekt możesz dodać z kilku miejsc:
+
+- pozycja **Add project** w palecie poleceń
+- przycisk **+** u góry paska bocznego sesji
+- przeglądarka folderów, gdy wybierasz katalog
+
+Wskaż folder, a OpenChamber go zapamięta. Nazwa pochodzi od folderu; możesz ją później zmienić.
+
+## Przełączaj projekty
+
+Wybierz projekt z paska bocznego, aby go aktywować. Wszystko — sesje, git, notatki — podąża za otwartym projektem.
+
+## Spraw, by projekt był rozpoznawalny
+
+Otwórz **Settings → Projects**, aby nadać projektowi własną nazwę, kolor lub ikonę. OpenChamber próbuje znaleźć ikonę automatycznie — zobacz [Ikony projektów](/pl/project-icons/).
+
+> W VS Code OpenChamber zawsze używa otwartego folderu jako jedynego projektu, więc nie ma nic do dodawania ani przełączania. Strona ustawień Projects jest tam ukryta.
+
+## Powiązane
+
+- [Notatki, listy zadań i plany projektu](/pl/notes-todos-plans/) — prowadź robocze notatki dla każdego projektu
+- [Akcje projektu](/pl/project-actions/) — zapisuj często uruchamiane polecenia
+- [Kontekst](/pl/context/) — zobacz, ile pamięci modelu zużywa sesja

packages/docs/content/docs/pl/providers.mdx

@@ -0,0 +1,49 @@
+---
+title: Dostawcy, modele i agenci
+description: Połącz dostawców AI, wybierz modele i skonfiguruj agentów.
+---
+
+# Dostawcy, modele i agenci
+
+Zanim OpenChamber cokolwiek zrobi, potrzebuje co najmniej jednego połączonego dostawcy AI. Ta strona opisuje łączenie dostawcy, wybór modelu i dostosowywanie agentów.
+
+## Połącz dostawcę
+
+1. Otwórz **Settings → Providers**.
+2. Otwórz menu **Add provider** i wybierz dostawcę, który nie jest jeszcze połączony.
+3. Zaloguj się na jeden z dwóch sposobów, zależnie od dostawcy:
+   - **Klucz API** — wklej swój klucz i zapisz.
+   - **Logowanie (device flow)** — OpenChamber pokazuje link i krótki kod. Otwórz link, wpisz kod i zatwierdź. OpenChamber sam dokończy łączenie.
+
+Gdy dostawca pokazuje się jako połączony, jego modele stają się dostępne w czacie.
+
+Aby się rozłączyć, otwórz dostawcę i wybierz usunięcie jego logowania.
+
+## Wybierz model
+
+Model wybierasz tam, gdzie pracujesz:
+
+- w czacie użyj selektora modelu w pasku wiadomości, aby ustawić dostawcę i model dla tej sesji
+- dla agenta ustaw model domyślny (poniżej)
+
+## Skonfiguruj agentów
+
+Agent to nazwana konfiguracja — model, osobowość i to, co wolno mu robić.
+
+1. Otwórz **Settings → Agents**.
+2. Wybierz agenta lub utwórz nowego.
+3. Edytuj dowolne z poniższych:
+   - **description** — do czego służy agent
+   - **model** — jego domyślny model
+   - **temperature** — jak kreatywne są jego odpowiedzi
+   - **prompt** — stałe instrukcje, których zawsze przestrzega
+   - **tool rules** — których narzędzi może używać
+
+## Gdzie są przechowywane Twoje logowania
+
+Logowania dostawców są przechowywane przez OpenCode, a nie OpenChamber, więc są współdzielone z OpenCode CLI. Jeśli ustawisz tego samego dostawcę w więcej niż jednym miejscu, wygrywa ustawienie najbardziej szczegółowe: ustawienie dla projektu nadpisuje Twoje osobiste.
+
+## Powiązane
+
+- [Serwery MCP](/pl/mcp/) — dodaj agentom dodatkowe narzędzia
+- [Zużycie i limity](/pl/usage/) — śledź, ile już wykorzystałeś

packages/docs/content/docs/pl/remote-instances.mdx

@@ -0,0 +1,30 @@
+---
+title: Zdalne instancje
+description: Połącz aplikację na komputerze z OpenChamber na innej maszynie przez SSH.
+---
+
+# Zdalne instancje
+
+Aplikacja na komputerze może połączyć się z OpenChamber działającym na innej maszynie przez SSH — serwer służbowy, maszyna w chmurze, homelab — i przenieść jego UI na Twój ekran, jakby był lokalny. Skonfiguruj to w **Settings → Remote Instances**.
+
+> Zdalne instancje to funkcja **tylko na komputerze**. W wersji webowej lub w VS Code połącz się ze zdalnym serwerem za pomocą zmiennych środowiskowych z [OpenCode Server](/pl/opencode-server/).
+
+## Dodaj zdalną instancję
+
+1. Otwórz **Settings → Remote Instances** i dodaj jedną.
+2. Podaj polecenie SSH, którego normalnie używasz, by dotrzeć do maszyny, oraz przydomek.
+3. Wybierz, jak OpenChamber tam działa:
+   - **managed** — OpenChamber instaluje i uruchamia się sam na zdalnej maszynie
+   - **external** — połącz się z tym, który już działa
+4. Połącz.
+
+OpenChamber przeprowadza przez kolejne kroki — sprawdzenie połączenia, skonfigurowanie zdalnej maszyny, uruchomienie serwera i przekazanie portu — i pokazuje, na jakim etapie się znajduje. Gdy osiągnie stan **ready**, zdalne UI ładuje się lokalnie.
+
+## Poświadczenia
+
+Sam decydujesz, czy zapisać hasła SSH i UI, czy wpisywać je za każdym razem. Jeśli połączenie zostanie zerwane, OpenChamber zgłasza, który krok zawiódł, byś mógł to naprawić — zobacz [Dostęp zdalny](/pl/troubleshooting/remote-access/).
+
+## Powiązane
+
+- [OpenCode Server](/pl/opencode-server/) — połącz się ze zdalnym serwerem w wersji webowej lub VS Code
+- [Dostęp zdalny](/pl/troubleshooting/remote-access/) — gdy połączenie nie chce się nawiązać

packages/docs/content/docs/pl/scheduled-tasks.mdx

@@ -0,0 +1,33 @@
+---
+title: Zaplanowane zadania
+description: Uruchamiaj prompt automatycznie według harmonogramu.
+---
+
+# Zaplanowane zadania
+
+Zaplanowane zadanie uruchamia za Ciebie prompt według harmonogramu — na przykład codzienne „podsumuj wczorajsze zmiany” albo cotygodniowe porządki. Gdy się uruchamia, OpenChamber rozpoczyna nową sesję i sam wysyła prompt. Otwórz harmonogram z przycisku u góry paska bocznego sesji.
+
+## Utwórz zadanie
+
+1. Otwórz okno zaplanowanych zadań z paska bocznego sesji.
+2. Dodaj zadanie i nadaj mu nazwę.
+3. Wybierz, kiedy się uruchamia:
+   - **daily** — o jednej lub kilku porach każdego dnia
+   - **weekly** — w wybrane dni tygodnia i godziny
+   - **once** — jedna data i godzina
+4. Ustaw, co robi: prompt do wysłania oraz dostawcę, model i agenta do użycia. Promptem może być polecenie z ukośnikiem, jak `/review`.
+5. Zapisz i upewnij się, że zadanie jest włączone.
+
+Dowolne zadanie możesz uruchomić natychmiast za pomocą **run now**, aby sprawdzić, czy robi to, czego oczekujesz.
+
+## Jak wygląda sukces
+
+Po uruchomieniu zadanie pokazuje, kiedy ostatnio się wykonało, czy się powiodło, oraz link do utworzonej sesji. Jeśli uruchomienie się nie powiedzie, błąd również jest tam pokazany.
+
+## Pamiętaj
+
+Zadania uruchamiają się tylko wtedy, gdy serwer OpenChamber działa. Jeśli go zamkniesz, zaplanowane uruchomienia są wstrzymane, dopóki nie wróci.
+
+## Powiązane
+
+- [Polecenia i fragmenty](/pl/commands-snippets/) — użyj ponownie polecenia z ukośnikiem jako promptu

packages/docs/content/docs/pl/security.mdx

@@ -0,0 +1,37 @@
+---
+title: Bezpieczeństwo
+description: Zabezpiecz UI hasłem i kluczami dostępu, zanim je udostępnisz.
+---
+
+# Bezpieczeństwo
+
+OpenChamber daje dostęp do Twojej maszyny i Twojego kodu, więc zabezpiecz go, zanim ktokolwiek poza Tobą będzie mógł do niego dotrzeć. Ta strona omawia hasło UI, klucze dostępu (passkeys) oraz to, co warto wiedzieć przed udostępnieniem OpenChamber w sieci.
+
+## Ustaw hasło UI
+
+Uruchom OpenChamber z hasłem, a interfejs webowy poprosi o nie:
+
+```bash
+openchamber --ui-password be-creative-here
+```
+
+Możesz też ustawić je za pomocą zmiennej środowiskowej `OPENCHAMBER_UI_PASSWORD`, zamiast podawać je w wierszu poleceń. Po zalogowaniu OpenChamber zapamiętuje urządzenie na pewien czas, więc nie pyta za każdym razem.
+
+Zawsze ustawiaj hasło, jeśli instancja jest dostępna dla kogokolwiek innego — zwłaszcza przez [tunel](/pl/tunnels/) lub publiczny internet.
+
+## Klucze dostępu (passkeys)
+
+Po ustawieniu hasła możesz dodać klucze dostępu (Face ID, Touch ID, klucz bezpieczeństwa) dla szybszego logowania. Dodaj je w **Settings → OpenChamber → Passkeys**.
+
+Klucze dostępu są powiązane z bieżącym hasłem. Jeśli zmienisz lub usuniesz hasło, zapisane klucze dostępu zostaną wyczyszczone i będziesz je dodawać ponownie.
+
+## Zanim ją udostępnisz
+
+- Domyślnie OpenChamber nasłuchuje tylko na Twojej własnej maszynie (`127.0.0.1`). Nasłuchiwanie szerzej wymaga celowej zmiany i najpierw powinieneś ustawić hasło.
+- Preferuj [tunel](/pl/tunnels/) lub sieć prywatną (jak VPN) zamiast otwierania portu do internetu.
+- Jeśli umieszczasz OpenChamber za własnym serwerem HTTPS, zobacz [Reverse Proxy](/pl/reverse-proxy/).
+
+## Powiązane
+
+- [Tunele](/pl/tunnels/) — zalecany sposób na zdalne dotarcie do instancji
+- [Reverse Proxy](/pl/reverse-proxy/) — uruchom OpenChamber za własnym serwerem