From 49fb6d8c080d5ae9116238bf74a18530848337ff Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 2 Jul 2026 01:04:03 +0000
Subject: [PATCH 01/10] Initial plan


From 1a089748014b900960aa2272adb512c73ab6544a Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 2 Jul 2026 01:06:22 +0000
Subject: [PATCH 02/10] Scaffold Codex project structure with devcontainer and
 database

---
 .devcontainer/Dockerfile        |   5 +
 .devcontainer/devcontainer.json |  18 +++
 .env.example                    |   5 +
 .gitignore                      |  29 +++++
 README.md                       | 209 ++++++--------------------------
 data/.gitkeep                   |   0
 docker-compose.yml              |  28 +++++
 docs/.gitkeep                   |   0
 scripts/.gitkeep                |   0
 src/.gitkeep                    |   0
 10 files changed, 123 insertions(+), 171 deletions(-)
 create mode 100644 .devcontainer/Dockerfile
 create mode 100644 .devcontainer/devcontainer.json
 create mode 100644 .env.example
 create mode 100644 .gitignore
 create mode 100644 data/.gitkeep
 create mode 100644 docker-compose.yml
 create mode 100644 docs/.gitkeep
 create mode 100644 scripts/.gitkeep
 create mode 100644 src/.gitkeep

diff --git a/.devcontainer/Dockerfile b/.devcontainer/Dockerfile
new file mode 100644
index 00000000..311d687b
--- /dev/null
+++ b/.devcontainer/Dockerfile
@@ -0,0 +1,5 @@
+FROM mcr.microsoft.com/devcontainers/base:ubuntu
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends postgresql-client \
+    && rm -rf /var/lib/apt/lists/*
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
new file mode 100644
index 00000000..7fe25864
--- /dev/null
+++ b/.devcontainer/devcontainer.json
@@ -0,0 +1,18 @@
+{
+  "name": "Codex Dev Container",
+  "dockerComposeFile": [
+    "../docker-compose.yml"
+  ],
+  "service": "app",
+  "workspaceFolder": "/workspaces/copilot-cli",
+  "shutdownAction": "stopCompose",
+  "features": {},
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-azuretools.vscode-docker",
+        "ms-python.python"
+      ]
+    }
+  }
+}
diff --git a/.env.example b/.env.example
new file mode 100644
index 00000000..b231d714
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,5 @@
+OPENAI_API_KEY=your_openai_api_key_here
+POSTGRES_USER=codex
+POSTGRES_PASSWORD=codex_password
+POSTGRES_DB=codex
+POSTGRES_PORT=5432
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 00000000..45b0e0d5
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,29 @@
+# Environment
+.env
+.env.*
+!.env.example
+
+# OS / Editor
+.DS_Store
+Thumbs.db
+.vscode/
+.idea/
+
+# Python
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.venv/
+venv/
+
+# Node
+node_modules/
+.npm/
+
+# Logs & caches
+*.log
+.cache/
+
+# Build artifacts
+dist/
+build/
diff --git a/README.md b/README.md
index 347cf2dc..303456c8 100644
--- a/README.md
+++ b/README.md
@@ -1,194 +1,61 @@
-# GitHub Copilot CLI
+# Codex
 
-The power of GitHub Copilot, now in your terminal.
+Repozytorium projektu **Codex** z przygotowanym szkieletem pod dalszy rozwój: dokumentację, kod aplikacji, dane, skrypty automatyzacji oraz środowisko developerskie oparte o Dev Container i Docker Compose.
 
-GitHub Copilot CLI brings AI-powered coding assistance directly to your command line, enabling you to build, debug, and understand code through natural language conversations. Powered by the same agentic harness as GitHub's Copilot coding agent, it provides intelligent assistance while staying deeply integrated with your GitHub workflow.
+## Struktura katalogów
 
-See [our official documentation](https://docs.github.com/copilot/concepts/agents/about-copilot-cli) for more information.
+- `.devcontainer/` – konfiguracja środowiska developerskiego w kontenerze.
+- `src/` – kod źródłowy aplikacji.
+- `docs/` – dokumentacja i zebrane informacje projektowe.
+- `data/` – dane lokalne/pliki pomocnicze wykorzystywane w projekcie.
+- `scripts/` – skrypty narzędziowe i automatyzujące.
 
-![Image of the splash screen for the Copilot CLI](https://github.com/user-attachments/assets/f40aa23d-09dd-499e-9457-1d57d3368887)
+## Dev Container
 
+Wymagania:
+- Docker Desktop / Docker Engine
+- VS Code + rozszerzenie **Dev Containers**
 
-## 🚀 Introduction and Overview
+Uruchomienie:
+1. Skopiuj plik środowiskowy:
+   ```bash
+   cp .env.example .env
+   ```
+2. Otwórz repozytorium w VS Code.
+3. Wybierz: **Dev Containers: Reopen in Container**.
 
-We're bringing the power of GitHub Copilot coding agent directly to your terminal. With GitHub Copilot CLI, you can work locally and synchronously with an AI agent that understands your code and GitHub context.
+Konfiguracja korzysta z `docker-compose.yml`, dzięki czemu kontener developerski działa razem z bazą danych.
 
-- **Terminal-native development:** Work with Copilot coding agent directly in your command line — no context switching required.
-- **GitHub integration out of the box:** Access your repositories, issues, and pull requests using natural language, all authenticated with your existing GitHub account.
-- **Agentic capabilities:** Build, edit, debug, and refactor code with an AI collaborator that can plan and execute complex tasks.
-- **MCP-powered extensibility:** Take advantage of the fact that the coding agent ships with GitHub's MCP server by default and supports custom MCP servers to extend capabilities.
-- **Full control:** Preview every action before execution — nothing happens without your explicit approval.
-
-We're still early in our journey, but with your feedback, we're rapidly iterating to make the GitHub Copilot CLI the best possible companion in your terminal.
-
-## 📦 Getting Started
-
-### Supported Platforms
-
-- **Linux**
-- **macOS**
-- **Windows**
-
-### Prerequisites
-
-- (On Windows) **PowerShell** v6 or higher
-- An **active Copilot subscription**. See [Copilot plans](https://github.com/features/copilot/plans?ref_cta=Copilot+plans+signup&ref_loc=install-copilot-cli&ref_page=docs).
-
-If you have access to GitHub Copilot via your organization or enterprise, you cannot use GitHub Copilot CLI if your organization owner or enterprise administrator has disabled it in the organization or enterprise settings. See [Managing policies and features for GitHub Copilot in your organization](http://docs.github.com/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/managing-policies-for-copilot-in-your-organization) for more information.
-
-### Installation
-
-Install with the install script (macOS and Linux):
+## Baza danych (Docker Compose)
 
+Start usług:
 ```bash
-curl -fsSL https://gh.io/copilot-install | bash
+docker compose up -d
 ```
 
-Or
-
-```bash
-wget -qO- https://gh.io/copilot-install | bash
-```
-
-Use `| sudo bash` to run as root and install to `/usr/local/bin`.
-
-Set `PREFIX` to install to `$PREFIX/bin/` directory. Defaults to `/usr/local`
-when run as root or `$HOME/.local` when run as a non-root user.
-
-Set `VERSION` to install a specific version. Defaults to the latest version.
-
-For example, to install version `v0.0.369` to a custom directory:
-
-```bash
-curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.369" PREFIX="$HOME/custom" bash
-```
-
-Install with [Homebrew](https://formulae.brew.sh/cask/copilot-cli) (macOS and Linux):
-
-```bash
-brew install copilot-cli
-```
-
-```bash
-brew install copilot-cli@prerelease
-```
-
-
-Install with [WinGet](https://github.com/microsoft/winget-cli) (Windows):
-
-```bash
-winget install GitHub.Copilot
-```
-
-```bash
-winget install GitHub.Copilot.Prerelease
-```
-
-
-Install with [npm](https://www.npmjs.com/package/@github/copilot) (macOS, Linux, and Windows):
-
+Zatrzymanie usług:
 ```bash
-npm install -g @github/copilot
+docker compose down
 ```
 
-```bash
-npm install -g @github/copilot@prerelease
-```
+Domyślne ustawienia PostgreSQL:
+- host: `localhost`
+- port: `5432`
+- user: `codex`
+- password: `codex_password`
+- database: `codex`
+- volume: `postgres_data`
 
+## Zmienne środowiskowe (OpenAI)
 
-### Launching the CLI
+W projekcie używany jest plik `.env` (lokalnie, niecommitowany). Bazuj na `.env.example` i ustaw swój klucz:
 
-```bash
-copilot
+```env
+OPENAI_API_KEY=your_openai_api_key_here
 ```
 
-On first launch, you'll be greeted with our adorable animated banner! If you'd like to see this banner again, launch `copilot` with the `--banner` flag.
-
-If you're not currently logged in to GitHub, you'll be prompted to use the `/login` slash command. Enter this command and follow the on-screen instructions to authenticate.
-
-#### Authenticate with a Personal Access Token (PAT)
-
-You can also authenticate using a fine-grained PAT with the "Copilot Requests" permission enabled.
-
-1. Visit https://github.com/settings/personal-access-tokens/new
-2. Under "Permissions," click "add permissions" and select "Copilot Requests"
-3. Generate your token
-4. Add the token to your environment via the environment variable `GH_TOKEN` or `GITHUB_TOKEN` (in order of precedence)
-
-### Using the CLI
-
-Launch `copilot` in a folder that contains code you want to work with.
-
-By default, `copilot` utilizes Claude Sonnet 4.5. Run the `/model` slash command to choose from other available models, including Claude Sonnet 4 and GPT-5.
-
-### Experimental Mode
-
-Experimental mode enables access to new features that are still in development. You can activate experimental mode by:
-
-- Launching with the `--experimental` flag: `copilot --experimental`
-- Using the `/experimental` slash command from within the CLI
-
-Once activated, the setting is persisted in your config, so the `--experimental` flag is no longer needed on subsequent launches.
-
-#### Experimental Features
-
-- **Autopilot mode:** Autopilot is a new mode (press `Shift+Tab` to cycle through modes), which encourages the agent to continue working until a task is completed.
-
-Each time you submit a prompt to GitHub Copilot CLI, your monthly quota of premium requests is reduced by one. For information about premium requests, see [About premium requests](https://docs.github.com/copilot/managing-copilot/monitoring-usage-and-entitlements/about-premium-requests).
-
-For more information about how to use the GitHub Copilot CLI, see [our official documentation](https://docs.github.com/copilot/concepts/agents/about-copilot-cli).
-
-## 🔧 Configuring LSP Servers
-
-GitHub Copilot CLI supports Language Server Protocol (LSP) for enhanced code intelligence. This feature provides intelligent code features like go-to-definition, hover information, and diagnostics.
-
-### Installing Language Servers
-
-Copilot CLI does not bundle LSP servers. You need to install them separately. For example, to set up TypeScript support:
+Możesz też wyeksportować zmienną w shellu:
 
 ```bash
-npm install -g typescript-language-server
-```
-
-For other languages, install the corresponding LSP server and configure it following the same pattern shown below.
-
-### Configuring LSP Servers
-
-LSP servers are configured through a dedicated LSP configuration file. You can configure LSP servers at the user level or repository level:
-
-**User-level configuration** (applies to all projects):
-Edit `~/.copilot/lsp-config.json`
-
-**Repository-level configuration** (applies to specific project):
-Create `.github/lsp.json` in your repository root
-
-Example configuration:
-
-```json
-{
-  "lspServers": {
-    "typescript": {
-      "command": "typescript-language-server",
-      "args": ["--stdio"],
-      "fileExtensions": {
-        ".ts": "typescript",
-        ".tsx": "typescript"
-      }
-    }
-  }
-}
+export OPENAI_API_KEY="your_openai_api_key_here"
 ```
-
-### Viewing LSP Server Status
-
-Check configured LSP servers using the `/lsp` command in an interactive session, or view your configuration files directly.
-
-For more information, see the [changelog](./changelog.md).
-
-## 📢 Feedback and Participation
-
-We're excited to have you join us early in the Copilot CLI journey.
-
-We're building quickly. Expect frequent updates--please keep your client up to date for the latest features and fixes!
-
-Your insights are invaluable! Open an issue in this repo, join Discussions, and run `/feedback` from the CLI to submit a confidential feedback survey!
diff --git a/data/.gitkeep b/data/.gitkeep
new file mode 100644
index 00000000..e69de29b
diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 00000000..fb152619
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,28 @@
+services:
+  app:
+    build:
+      context: .
+      dockerfile: .devcontainer/Dockerfile
+    command: sleep infinity
+    env_file:
+      - path: .env
+        required: false
+    volumes:
+      - .:/workspaces/copilot-cli:cached
+    depends_on:
+      - db
+
+  db:
+    image: postgres:16-alpine
+    restart: unless-stopped
+    ports:
+      - "5432:5432"
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-codex}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-codex_password}
+      POSTGRES_DB: ${POSTGRES_DB:-codex}
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+
+volumes:
+  postgres_data:
diff --git a/docs/.gitkeep b/docs/.gitkeep
new file mode 100644
index 00000000..e69de29b
diff --git a/scripts/.gitkeep b/scripts/.gitkeep
new file mode 100644
index 00000000..e69de29b
diff --git a/src/.gitkeep b/src/.gitkeep
new file mode 100644
index 00000000..e69de29b

From 6d5d3ba55421e656174e4c505eec4c5a4c8f49eb Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 2 Jul 2026 01:07:07 +0000
Subject: [PATCH 03/10] Align devcontainer workspace paths with Codex naming

---
 .devcontainer/devcontainer.json | 2 +-
 docker-compose.yml              | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
index 7fe25864..7927350d 100644
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@@ -4,7 +4,7 @@
     "../docker-compose.yml"
   ],
   "service": "app",
-  "workspaceFolder": "/workspaces/copilot-cli",
+  "workspaceFolder": "/workspaces/codex",
   "shutdownAction": "stopCompose",
   "features": {},
   "customizations": {
diff --git a/docker-compose.yml b/docker-compose.yml
index fb152619..93d5fd07 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -8,7 +8,7 @@ services:
       - path: .env
         required: false
     volumes:
-      - .:/workspaces/copilot-cli:cached
+      - .:/workspaces/codex:cached
     depends_on:
       - db
 

From dc31d44af941bb8c47eaa8feac9b751c8f8b529a Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 2 Jul 2026 01:07:51 +0000
Subject: [PATCH 04/10] Harden default PostgreSQL password guidance

---
 .env.example       | 2 +-
 README.md          | 4 +++-
 docker-compose.yml | 2 +-
 3 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/.env.example b/.env.example
index b231d714..cb90e874 100644
--- a/.env.example
+++ b/.env.example
@@ -1,5 +1,5 @@
 OPENAI_API_KEY=your_openai_api_key_here
 POSTGRES_USER=codex
-POSTGRES_PASSWORD=codex_password
+POSTGRES_PASSWORD=change_me_local_only
 POSTGRES_DB=codex
 POSTGRES_PORT=5432
diff --git a/README.md b/README.md
index 303456c8..be377f86 100644
--- a/README.md
+++ b/README.md
@@ -42,10 +42,12 @@ Domyślne ustawienia PostgreSQL:
 - host: `localhost`
 - port: `5432`
 - user: `codex`
-- password: `codex_password`
+- password: `change_me_local_only`
 - database: `codex`
 - volume: `postgres_data`
 
+> ⚠️ Przed użyciem poza środowiskiem lokalnym ustaw własne, silne hasło `POSTGRES_PASSWORD`.
+
 ## Zmienne środowiskowe (OpenAI)
 
 W projekcie używany jest plik `.env` (lokalnie, niecommitowany). Bazuj na `.env.example` i ustaw swój klucz:
diff --git a/docker-compose.yml b/docker-compose.yml
index 93d5fd07..48812e43 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -19,7 +19,7 @@ services:
       - "5432:5432"
     environment:
       POSTGRES_USER: ${POSTGRES_USER:-codex}
-      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-codex_password}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-change_me_local_only}
       POSTGRES_DB: ${POSTGRES_DB:-codex}
     volumes:
       - postgres_data:/var/lib/postgresql/data

From 37dcad4762b37bf7e81c2dea866c820e0d6bd7b8 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 2 Jul 2026 01:08:32 +0000
Subject: [PATCH 05/10] Polish devcontainer and README wording

---
 .devcontainer/devcontainer.json | 1 -
 README.md                       | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
index 7927350d..c5d85d47 100644
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@@ -6,7 +6,6 @@
   "service": "app",
   "workspaceFolder": "/workspaces/codex",
   "shutdownAction": "stopCompose",
-  "features": {},
   "customizations": {
     "vscode": {
       "extensions": [
diff --git a/README.md b/README.md
index be377f86..8c7e76b0 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # Codex
 
-Repozytorium projektu **Codex** z przygotowanym szkieletem pod dalszy rozwój: dokumentację, kod aplikacji, dane, skrypty automatyzacji oraz środowisko developerskie oparte o Dev Container i Docker Compose.
+Repozytorium projektu **Codex** z przygotowanym szkieletem pod dalszy rozwój: dokumentację, kod aplikacji, dane, skrypty automatyzacji oraz środowisko developerskie oparte na Dev Container i Docker Compose.
 
 ## Struktura katalogów
 

From 383454475bc3ea14c68d3d4429a4906f693602be Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 2 Jul 2026 01:09:17 +0000
Subject: [PATCH 06/10] Refine Polish terminology in Codex README

---
 README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 8c7e76b0..b8564eb1 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,10 @@
 # Codex
 
-Repozytorium projektu **Codex** z przygotowanym szkieletem pod dalszy rozwój: dokumentację, kod aplikacji, dane, skrypty automatyzacji oraz środowisko developerskie oparte na Dev Container i Docker Compose.
+Repozytorium projektu **Codex** z przygotowanym szkieletem pod dalszy rozwój: dokumentację, kod aplikacji, dane, skrypty automatyzacji oraz środowisko deweloperskie oparte na Dev Container i Docker Compose.
 
 ## Struktura katalogów
 
-- `.devcontainer/` – konfiguracja środowiska developerskiego w kontenerze.
+- `.devcontainer/` – konfiguracja środowiska deweloperskiego w kontenerze.
 - `src/` – kod źródłowy aplikacji.
 - `docs/` – dokumentacja i zebrane informacje projektowe.
 - `data/` – dane lokalne/pliki pomocnicze wykorzystywane w projekcie.
@@ -24,7 +24,7 @@ Uruchomienie:
 2. Otwórz repozytorium w VS Code.
 3. Wybierz: **Dev Containers: Reopen in Container**.
 
-Konfiguracja korzysta z `docker-compose.yml`, dzięki czemu kontener developerski działa razem z bazą danych.
+Konfiguracja korzysta z `docker-compose.yml`, dzięki czemu kontener deweloperski działa razem z bazą danych.
 
 ## Baza danych (Docker Compose)
 

From 36ec57a045efdc8abda99ef8f67c9bb60c0e5d10 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 2 Jul 2026 01:10:15 +0000
Subject: [PATCH 07/10] Require explicit PostgreSQL password configuration

---
 .env.example       | 2 +-
 README.md          | 4 ++--
 docker-compose.yml | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.env.example b/.env.example
index cb90e874..88be60d2 100644
--- a/.env.example
+++ b/.env.example
@@ -1,5 +1,5 @@
 OPENAI_API_KEY=your_openai_api_key_here
 POSTGRES_USER=codex
-POSTGRES_PASSWORD=change_me_local_only
+POSTGRES_PASSWORD=your_secure_password_here
 POSTGRES_DB=codex
 POSTGRES_PORT=5432
diff --git a/README.md b/README.md
index b8564eb1..09efd6d1 100644
--- a/README.md
+++ b/README.md
@@ -42,11 +42,11 @@ Domyślne ustawienia PostgreSQL:
 - host: `localhost`
 - port: `5432`
 - user: `codex`
-- password: `change_me_local_only`
+- password: wartość `POSTGRES_PASSWORD` z pliku `.env`
 - database: `codex`
 - volume: `postgres_data`
 
-> ⚠️ Przed użyciem poza środowiskiem lokalnym ustaw własne, silne hasło `POSTGRES_PASSWORD`.
+> ⚠️ Ustaw własne, silne hasło `POSTGRES_PASSWORD` w `.env` przed uruchomieniem usług.
 
 ## Zmienne środowiskowe (OpenAI)
 
diff --git a/docker-compose.yml b/docker-compose.yml
index 48812e43..6c5cc825 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -19,7 +19,7 @@ services:
       - "5432:5432"
     environment:
       POSTGRES_USER: ${POSTGRES_USER:-codex}
-      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-change_me_local_only}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?Set POSTGRES_PASSWORD in .env}
       POSTGRES_DB: ${POSTGRES_DB:-codex}
     volumes:
       - postgres_data:/var/lib/postgresql/data

From 869bdd393e7e170e9691cfe3d7e67dc1d0dc4847 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 2 Jul 2026 01:11:00 +0000
Subject: [PATCH 08/10] Sync compose port env and clarify README setup

---
 README.md          | 4 +++-
 docker-compose.yml | 2 +-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 09efd6d1..16badecc 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # Codex
 
-Repozytorium projektu **Codex** z przygotowanym szkieletem pod dalszy rozwój: dokumentację, kod aplikacji, dane, skrypty automatyzacji oraz środowisko deweloperskie oparte na Dev Container i Docker Compose.
+Repozytorium projektu **Codex** z przygotowanym szkieletem do dalszego rozwoju, obejmującym dokumentację, kod aplikacji, dane, skrypty automatyzacji oraz środowisko deweloperskie oparte na Dev Container i Docker Compose.
 
 ## Struktura katalogów
 
@@ -56,6 +56,8 @@ W projekcie używany jest plik `.env` (lokalnie, niecommitowany). Bazuj na `.env
 OPENAI_API_KEY=your_openai_api_key_here
 ```
 
+Ta zmienna będzie wykorzystywana przez komponenty aplikacji rozwijane w `src/` (np. moduły integracji z API OpenAI).
+
 Możesz też wyeksportować zmienną w shellu:
 
 ```bash
diff --git a/docker-compose.yml b/docker-compose.yml
index 6c5cc825..f7316fe6 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -16,7 +16,7 @@ services:
     image: postgres:16-alpine
     restart: unless-stopped
     ports:
-      - "5432:5432"
+      - "${POSTGRES_PORT:-5432}:5432"
     environment:
       POSTGRES_USER: ${POSTGRES_USER:-codex}
       POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?Set POSTGRES_PASSWORD in .env}

From 6712f17699d346cab31239059e03e3e43632d128 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 2 Jul 2026 01:11:47 +0000
Subject: [PATCH 09/10] Finalize README compose wording and password
 placeholder

---
 .env.example | 2 +-
 README.md    | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.env.example b/.env.example
index 88be60d2..8af606c8 100644
--- a/.env.example
+++ b/.env.example
@@ -1,5 +1,5 @@
 OPENAI_API_KEY=your_openai_api_key_here
 POSTGRES_USER=codex
-POSTGRES_PASSWORD=your_secure_password_here
+POSTGRES_PASSWORD=CHANGE_ME_TO_SECURE_PASSWORD
 POSTGRES_DB=codex
 POSTGRES_PORT=5432
diff --git a/README.md b/README.md
index 16badecc..44500bfb 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,7 @@ Uruchomienie:
 2. Otwórz repozytorium w VS Code.
 3. Wybierz: **Dev Containers: Reopen in Container**.
 
-Konfiguracja korzysta z `docker-compose.yml`, dzięki czemu kontener deweloperski działa razem z bazą danych.
+Konfiguracja korzysta z Docker Compose (`docker compose`), dzięki czemu kontener deweloperski działa razem z bazą danych.
 
 ## Baza danych (Docker Compose)
 

From fe45b6dd161754e8a4a8e7f735dcabb9cb8a5ceb Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 2 Jul 2026 01:12:29 +0000
Subject: [PATCH 10/10] Use explicit secure password placeholder in env example

---
 .env.example | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.env.example b/.env.example
index 8af606c8..951f8125 100644
--- a/.env.example
+++ b/.env.example
@@ -1,5 +1,5 @@
 OPENAI_API_KEY=your_openai_api_key_here
 POSTGRES_USER=codex
-POSTGRES_PASSWORD=CHANGE_ME_TO_SECURE_PASSWORD
+POSTGRES_PASSWORD=__SET_SECURE_PASSWORD__
 POSTGRES_DB=codex
 POSTGRES_PORT=5432