Initial commit

README.md

@@ -0,0 +1,37 @@
+# opencode-container
+
+Run OpenCode inside an Arch Linux Docker container that closely mirrors a
+local development environment, while limiting access to sensitive files on
+the host.
+
+## Features
+
+- Arch Linux–based image
+- Runs as the host user (same username, UID, GID)
+- Mounts only the current project directory (same absolute path inside container)
+- Persists OpenCode state via XDG directories
+- No access to SSH keys, passwords, or full `$HOME`
+- Simple shell function (`opencode`) to launch interactively
+
+## Install
+
+Change to your projects directory and clone the repository:
+
+```
+cd ~/Projects/
+git clone https://git.jeena.net/jeena/opencode-container.git
+```
+Source the helper file `opencode.aliases` in your shell configuration  
+(`.bashrc` or `.zshrc`) so the `opencode` function is available in new sessions.
+
+## Usage
+
+From any project directory:
+
+```
+opencode
+```
+
+The image is built automatically on first use if it does not already exist.  
+OpenCode starts inside the container with the current directory mounted and
+set as the working directory.