Skip to content

docs: add Spanish README - #789

Open
webbrain-one wants to merge 1 commit into
100yenadmin:mainfrom
webbrain-one:webbrain/readme-translation
Open

docs: add Spanish README#789
webbrain-one wants to merge 1 commit into
100yenadmin:mainfrom
webbrain-one:webbrain/readme-translation

Conversation

@webbrain-one

@webbrain-one webbrain-one commented Jul 27, 2026

Copy link
Copy Markdown

Adds README.es-ES.md alongside the original documentation.

Summary by CodeRabbit

  • Documentation
    • Added comprehensive Spanish documentation for Lossless Codex Orchestrator.
    • Documented core capabilities, workflows, CLI and MCP tooling, and OpenClaw integration.
    • Added installation, configuration, troubleshooting, privacy, compatibility, contribution, architecture, roadmap, and licensing guidance.
    • Included examples for discovering, searching, expanding, and comparing project work.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 63d13bc10c

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread README.es-ES.md
@@ -0,0 +1,367 @@
# Lossless Codex Orchestrator

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Expose the translation from the landing page

Spanish-speaking visitors who open the normal repository URL are still shown README.md, and a repo-wide search finds no reference to README.es-ES.md; because this file also has no language selector, users must guess its filename, making the new translation effectively undiscoverable. Add an Español link to README.md and a reciprocal English link here so the public landing page exposes the translation.

AGENTS.md reference: AGENTS.md:L43-L46

Useful? React with 👍 / 👎.

@coderabbitai

coderabbitai Bot commented Jul 27, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: b6d8c687-99b6-46db-b6d2-2a77f45df72c

📥 Commits

Reviewing files that changed from the base of the PR and between 4384302 and 63d13bc.

📒 Files selected for processing (1)
  • README.es-ES.md
📜 Recent review details
🧰 Additional context used
🪛 LanguageTool
README.es-ES.md

[style] ~5-~5: Se recomienda emplear una alternativa al verbo comodín ‘realizar’.
Context: ...s e hilos de Codex. Codex es excelente realizando el trabajo. La parte difícil es gestion...

(REALIZAR)


[typographical] ~30-~30: En una tipografía cuidada, use comillas tipográficas.
Context: ...x intensamente, el problema deja de ser "¿puede un agente programar?" y se convie...

(COMILLAS_TIPOGRAFICAS)


[typographical] ~30-~30: En una tipografía cuidada, use comillas tipográficas.
Context: ...deja de ser "¿puede un agente programar?" y se convierte en "¿puede mi agente pri...

(COMILLAS_TIPOGRAFICAS)


[typographical] ~30-~30: En una tipografía cuidada, use comillas tipográficas.
Context: ...un agente programar?" y se convierte en "¿puede mi agente principal entender todo...

(COMILLAS_TIPOGRAFICAS)


[typographical] ~30-~30: En una tipografía cuidada, use comillas tipográficas.
Context: ...r todo el trabajo que ya está en marcha?". LCO le otorga a ese agente principal ...

(COMILLAS_TIPOGRAFICAS)


[typographical] ~40-~40: En una tipografía cuidada, use comillas tipográficas.
Context: ... Codex directamente al orquestador. | | "Continuar este trabajo" es arriesgado po...

(COMILLAS_TIPOGRAFICAS)


[typographical] ~40-~40: En una tipografía cuidada, use comillas tipográficas.
Context: ...orquestador. | | "Continuar este trabajo" es arriesgado porque el objetivo puede ...

(COMILLAS_TIPOGRAFICAS)


[typographical] ~52-~52: En una tipografía cuidada, use comillas tipográficas.
Context: ...s para que los agentes puedan encontrar "el plan del billing bridge" o "el PR que...

(COMILLAS_TIPOGRAFICAS)


[typographical] ~52-~52: En una tipografía cuidada, use comillas tipográficas.
Context: ...an encontrar "el plan del billing bridge" o "el PR que tocó la autenticación" sin...

(COMILLAS_TIPOGRAFICAS)


[typographical] ~52-~52: En una tipografía cuidada, use comillas tipográficas.
Context: ...ncontrar "el plan del billing bridge" o "el PR que tocó la autenticación" sin el ...

(COMILLAS_TIPOGRAFICAS)


[typographical] ~52-~52: En una tipografía cuidada, use comillas tipográficas.
Context: ...idge" o "el PR que tocó la autenticación" sin el ID exacto del hilo. - Detecta de...

(COMILLAS_TIPOGRAFICAS)


[typographical] ~58-~58: En una tipografía cuidada, use comillas tipográficas.
Context: ... tu agente principal pueda comenzar con "¿qué necesita mi atención?" en lugar de ...

(COMILLAS_TIPOGRAFICAS)


[typographical] ~58-~58: En una tipografía cuidada, use comillas tipográficas.
Context: ...comenzar con "¿qué necesita mi atención?" en lugar de una búsqueda bruta. - Rastr...

(COMILLAS_TIPOGRAFICAS)


[style] ~73-~73: En sentido figurado es preferible usar otras expresiones.
Context: ...ect_digest` crea un resumen de traspaso a nivel de proyecto a partir de tarjetas de Codex,...

(A_NIVEL_DE)


[uncategorized] ~80-~80: Hint: «real» (Spanish) means «royal», «real», «actual» (English). Did you mean «verdadero», «auténtico»?
Context: ...dan ser revisados antes de la ejecución real. - Para acciones reales de Codex, el pa...

(REAL)


[uncategorized] ~81-~81: Hint: «real» (Spanish) means «royal», «real», «actual» (English). Did you mean «verdadero», «auténtico»?
Context: ...s de la ejecución real. - Para acciones reales de Codex, el paquete puede incluir el o...

(REAL)


[uncategorized] ~82-~82: Hint: «actualmente» (Spanish) means «currently», «presently» (English). Did you mean «real»?
Context: ...a de control en vivo de Codex soportada actualmente a approvalPolicy=never y un sandbox d...

(ACTUAL)


[style] ~82-~82: Considere alternativas para este anglicismo (recomendable sobre todo en contextos más formales).
Context: ...tualmente a approvalPolicy=never y un sandbox de solo lectura sin red; LCO no hereda ...

(ES_SIMPLE_REPLACE_ANGLICISM_PREMIUMPICKY_SANDBOX)


[typographical] ~93-~93: En una tipografía cuidada, use comillas tipográficas.
Context: ...- quieres un lugar único para preguntar "¿qué está activo, bloqueado, obsoleto, t...

(COMILLAS_TIPOGRAFICAS)


[typographical] ~93-~93: En una tipografía cuidada, use comillas tipográficas.
Context: ... bloqueado, obsoleto, terminado o listo?" - quieres resúmenes de proyecto y breve...

(COMILLAS_TIPOGRAFICAS)


[uncategorized] ~105-~105: Si no es un título, falta un punto al final de la frase.
Context: ...enClaw llame a las herramientas lco_* instaladas Instalación estable: ```bash npm inst...

(FINAL_STOP)


[uncategorized] ~114-~114: Hint: «actual» (Spanish) means «current», «present» (English). Did you mean «real»?
Context: ...ssless-codex-orchestrator` es el nombre actual del paquete npm publicado. El paquete d...

(ACTUAL)


[uncategorized] ~129-~129: Hint: «actual» (Spanish) means «current», «present» (English). Did you mean «real»?
Context: ...ta ``` Canales de paquetes: - Estable actual: 1.6.0 distribuido en `latest` como l...

(ACTUAL)


[typographical] ~129-~129: En una tipografía cuidada, use comillas tipográficas.
Context: ...ia de sesión acotados, pruebas secas de "revisar-y-conducir" con presupuestos y v...

(COMILLAS_TIPOGRAFICAS)


[typographical] ~129-~129: En una tipografía cuidada, use comillas tipográficas.
Context: ...os, pruebas secas de "revisar-y-conducir" con presupuestos y vinculación de audit...

(COMILLAS_TIPOGRAFICAS)


[style] ~134-~134: Considere alternativas para este anglicismo (recomendable sobre todo en contextos más formales).
Context: ...viación de selector de npm con comandos raw que una shell fresca pueda ejecutar: `...

(ES_SIMPLE_REPLACE_ANGLICISM_PREMIUMPICKY_RAW)


[typographical] ~159-~159: En una tipografía cuidada, utilice el carácter adecuado de guion largo (raya).
Context: ...codex_index_limited_files_skipped, usa --max-bytes-per-file y--max-eve...

(GUION_LARGO)


[typographical] ~159-~159: En una tipografía cuidada, utilice el carácter adecuado de guion largo (raya).
Context: ..., usa --max-bytes-per-file y--max-events-per-file ` solo cuand...

(GUION_LARGO)


[typographical] ~176-~176: En una tipografía cuidada, utilice el carácter adecuado de guion largo (raya).
Context: ...eparación e integridad de los pares con lco doctor --peers; los pares se clasifican como lis...

(GUION_LARGO)


[style] ~187-~187: En sentido figurado es preferible usar otras expresiones.
Context: ...as, resúmenes y fragmentos de contenido a nivel de evento: ```bash lco find "billing brid...

(A_NIVEL_DE)


[uncategorized] ~193-~193: Hint: «forma» (Spanish) means «shape» (English). Did you mean «formulario»?
Context: ..." ``` Usa JSON cuando quieras la misma forma de resultado en scripts o arneses de ag...

(FORM)


[style] ~193-~193: Considere alternativas para este anglicismo (recomendable sobre todo en contextos más formales).
Context: ... quieras la misma forma de resultado en scripts o arneses de agentes: ```bash lco find...

(ES_SIMPLE_REPLACE_ANGLICISM_PREMIUMPICKY_SCRIPTS)


[typographical] ~207-~207: En una tipografía cuidada, use comillas tipográficas.
Context: ...r ``` Construye un paquete de "revisar-y-conducir" acotado sin ejecutar...

(COMILLAS_TIPOGRAFICAS)


[typographical] ~207-~207: En una tipografía cuidada, use comillas tipográficas.
Context: ...struye un paquete de "revisar-y-conducir" acotado sin ejecutar el control en vivo...

(COMILLAS_TIPOGRAFICAS)


[typographical] ~213-~213: En una tipografía cuidada, utilice el carácter adecuado de guion largo (raya).
Context: ...stura de integridad de solo lectura con lco doctor --peers. El direccionamiento de Claude en...

(GUION_LARGO)


[style] ~243-~243: En sentido figurado es preferible usar otras expresiones.
Context: ...roject_digest| Un resumen de traspaso a nivel de proyecto. | | 8 |lco_codex_control_dr...

(A_NIVEL_DE)


[style] ~311-~311: Considere alternativas para este anglicismo (recomendable sobre todo en contextos más formales).
Context: ...ugar de abrir archivos de transcripción raw enormes por defecto. Para más detalles...

(ES_SIMPLE_REPLACE_ANGLICISM_PREMIUMPICKY_RAW)


[style] ~324-~324: Es preferible evitar este anglicismo.
Context: ...ión, la ruta de comandos y la evidencia sanitizada disponible para probarlo. Nunca pegues...

(SANITIZAR)


[style] ~326-~326: Considere alternativas para este anglicismo (recomendable sobre todo en contextos más formales).
Context: ...probarlo. Nunca pegues transcripciones raw de Codex, bases de datos SQLite privada...

(ES_SIMPLE_REPLACE_ANGLICISM_PREMIUMPICKY_RAW)


[uncategorized] ~346-~346: Hint: «actual» (Spanish) means «current», «present» (English). Did you mean «real»?
Context: ...s dos versiones menores. El paquete npm actual es lossless-codex-orchestrator; el pa...

(ACTUAL)


[uncategorized] ~365-~365: Hint: «actual» (Spanish) means «current», «present» (English). Did you mean «real»?
Context: ...NTRIBUTING.md). ## Licencia La fuente actual y las versiones publicadas en npm están...

(ACTUAL)

🔇 Additional comments (3)
README.es-ES.md (3)

82-83: 🔒 Security & Privacy

Verify the documented Codex control guarantees against runtime enforcement.

This paragraph makes security-critical claims about approvalPolicy=never, read-only/no-network sandboxing, and rejection of unsafe steering/interruption. Confirm these guarantees are enforced by the implementation and covered by tests; otherwise the README may overstate the safety boundary.


100-105: 📐 Maintainability & Code Quality

Keep setup and release metadata synchronized with source of truth.

The README hard-codes Node.js 22.5+, compatibility-package behavior, and latest as version 1.6.0. Verify these against package.json, CI/toolchain configuration, and npm dist-tags before merging, and consider generating the version claim during releases to prevent drift.

Also applies to: 114-132


26-26: 📐 Maintainability & Code Quality

All relative documentation links resolve.


📝 Walkthrough

Walkthrough

README.es-ES.md adds complete Spanish documentation covering LCO’s purpose, capabilities, installation, configuration, workflows, integrations, privacy, architecture, development, roadmap, and licensing.

Changes

Spanish README documentation

Layer / File(s) Summary
Product overview and audience
README.es-ES.md
Introduces LCO, its memory and orchestration capabilities, supported command surfaces, and intended usage scenarios.
Installation and local configuration
README.es-ES.md
Documents package installation, version selection, local indexing configuration, caching controls, peer databases, and readiness checks.
Discovery workflows and integrations
README.es-ES.md
Describes discovery and retrieval commands, MCP tool sequences, compatibility targets, Claude Code usage, OpenClaw setup, and tool profiles.
Privacy, architecture, development, and licensing
README.es-ES.md
Adds local-data and contribution guidance, architecture and roadmap descriptions, developer commands, testing notes, and licensing requirements.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Suggested labels: documentation

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main change: adding a Spanish README translation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@evaos-code-review-bot

evaos-code-review-bot Bot commented Jul 27, 2026

Copy link
Copy Markdown

evaOS review status: completed

PR: #789 - docs: add Spanish README
Head: 63d13bc10c4aa3b7f4470bbf52e8ca9bbf9f7527
Updated: 2026-07-27T13:26:13.752Z

evaOS review completed for this PR head.

Automation note: agents should wait for this comment to reach completed, stale_head, closed_or_merged_before_review, skipped, or failed before treating evaOS review as settled for this head. provider_deferred means evaOS still intends to retry.

PR URL: #789

Review URL: #789 (review)

@coderabbitai coderabbitai Bot added the documentation Improvements or additions to documentation label Jul 27, 2026

@evaos-code-review-bot evaos-code-review-bot Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Walkthrough

PR: #789 - docs: add Spanish README
Head: 63d13bc10c4aa3b7f4470bbf52e8ca9bbf9f7527 into main. Review event: COMMENT.
Provider: GLM/Z.ai through ZCode (zcode-glm, zcode, model GLM-5.2).

Estimated review effort: 1/5 (~10 min)

Changed Files

File Status Churn Purpose Risk

Review Signal

No validated inline findings.
Dropped findings before posting: 0. High-severity findings: 0.

Risk Taxonomy

No finding categories.

Validation and Proof

Documentation-only changed surface; runtime execution proof is not required by default.

  • recommended: Docs/readme review - All reviewed files are documentation paths. Proof: PR description notes the docs intent.
    Proof status: not_applicable - No required behavior proof selected for this changed surface.
    Profile validation hints: Call out evidence leakage, replay/collision risks, duplicate side effects, and brittle sanitizer logic.
    Profile proof expectations: Look for focused sanitizer, signature, orchestration, or fixture proof.

Related Context

Related issues/PRs: none detected from PR metadata.
Suggested labels: none.
Suggested reviewers: none from current metadata.

Review Settings Preview

  • Profile: assertive
  • Enabled sections: Review summary (inline_review); Walkthrough (inline_review); Changed-files table (walkthrough); Effort estimate (walkthrough); Related issues/PRs (walkthrough); Suggested labels (suggestion_only); Review status comment (sticky_status)
  • Path instructions: none
  • Label suggestions: orchestration, security, regression-hardening
  • Reviewer suggestions: none
  • Suggestion behavior: suggestions only; labels and reviewers are not auto-applied.
  • Roadmap-only settings: auto-apply labels; auto-request reviewers; required status checks

Pre-merge checklist

  • Inline comments target current RIGHT-side diff lines.
  • No secret-like content survived into posted inline comments.
  • REQUEST_CHANGES is only used when eligible P0/P1 findings survive validation.
  • Required behavior proof is present or not applicable.
  • Labels and reviewers are suggestions only; the bot did not auto-apply them.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant