From 91d8ae8086179ed2cc6397ed3a832dd8d120e515 Mon Sep 17 00:00:00 2001
From: Tomas Krejci <tk@tomaskrejci.com>
Date: Mon, 1 Jun 2026 17:25:29 +0200
Subject: [PATCH] Document Codex usage

---
 README.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/README.md b/README.md
index 6d43a71..b7b7e4f 100644
--- a/README.md
+++ b/README.md
@@ -189,3 +189,21 @@ If `psql` cannot connect, verify that PostgreSQL is listening locally and that t
 - Project documentation is written in English.
 - Code comments are written in English.
 - User-facing chat responses for this project should be in Czech unless the user asks otherwise.
+
+## Codex
+
+Use Codex from the repository root so it can read `README.md`, `AGENTS.md`, and the local project files.
+
+Start a new Codex session:
+
+```bash
+npx @openai/codex --no-alt-screen -s workspace-write
+```
+
+Resume an existing Codex session:
+
+```bash
+npx @openai/codex resume <session-id> --no-alt-screen -s workspace-write
+```
+
+For repository-specific agent behavior, see `AGENTS.md`.