Release/v2.3.0 (#22)

* package.json: Add keywords

* docker.ts: Force COLORTERM=truecolor

* docker.ts: Load DOCKER_FLAGS.txt in exec

* feat: Add DOCKER_RUN_FLAGS.txt

* 2.3.0

Author: kevinMEH

AGENTS.md

@@ -30,7 +30,7 @@ If your user is a developer, proceed like normal.
 ## Key Features
 
 - **Security**: Destructive operations localized to containers
-- **Customization**: Add packages via `~/.code-container/Dockerfile`, mounts via `MOUNTS.txt`, flags via `DOCKER_FLAGS.txt`
+- **Customization**: Add packages via `~/.code-container/Dockerfile`, mounts via `MOUNTS.txt`, flags via `DOCKER_FLAGS.txt` and `DOCKER_RUN_FLAGS.txt`
 - **Simultaneous Work**: Multiple agents can work on same project safely
 - **Persistence**: Container state and harness configs persist
 
@@ -69,14 +69,14 @@ If your user is a developer, proceed like normal.
 
 - `src/commands.ts` — Business logic for all CLI commands. Image building, container lifecycle, listing, cleaning. Exports: `buildImage`, `init`, `runContainer`, `stopContainerForProject`, `removeContainerForProject`, `listContainers`, `cleanContainers`
 - `src/docker.ts` — Low-level Docker CLI wrappers. Image/container operations, interactive sessions, naming via SHA1 hash. Exports: `checkDocker`, `imageExists`, `buildImageRaw`, `containerExists`, `containerRunning`, `createNewContainer`, `execInteractive`, `stopContainer`, `startContainer`, `removeContainer`, `generateContainerName`
-- `src/config.ts` — Configuration paths and settings persistence. Manages `~/.code-container/` directory. Exports: `APPDATA_DIR`, `CONFIGS_DIR`, `DOCKERFILE_PATH`, `SETTINGS_PATH`, `MOUNTS_PATH`, `FLAGS_PATH`, `loadSettings`, `saveSettings`, `copyConfigs`, `ensureConfigDir`
+- `src/config.ts` — Configuration paths and settings persistence. Manages `~/.code-container/` directory. Exports: `APPDATA_DIR`, `CONFIGS_DIR`, `DOCKERFILE_PATH`, `SETTINGS_PATH`, `MOUNTS_PATH`, `FLAGS_PATH`, `RUN_FLAGS_PATH`, `loadSettings`, `saveSettings`, `copyConfigs`, `ensureConfigDir`
 - `src/mounts.ts` — Volume mount management. Core mounts (configs, gitconfig) and optional SSH mounting. Exports: `ensureMountsFile`, `loadMounts`, `getCoreMounts`
-- `src/flags.ts` — Custom Docker flags loader from `DOCKER_FLAGS.txt`. Uses shell-quote for safe parsing. Exports: `loadFlags`
+- `src/flags.ts` — Custom Docker flags loaders from `DOCKER_FLAGS.txt` and `DOCKER_RUN_FLAGS.txt`. Uses shell-quote for safe parsing. `DOCKER_FLAGS.txt` is loaded for both `docker run` and `docker exec`. `DOCKER_RUN_FLAGS.txt` is loaded only for `docker run`. Exports: `loadFlags`, `loadRunFlags`
 - `src/utils.ts` — Colored console output and user prompts. Exports: `printInfo`, `printSuccess`, `printWarning`, `printError`, `promptYesNo`, `resolveProjectPath`
 
 ## Scripts Index (`scripts/`)
 
-- `scripts/postinstall.js` — NPM post-install hook. Creates `~/.code-container/` structure and copies default Dockerfile.
+- `scripts/postinstall.js` — NPM post-install hook. Creates `~/.code-container/` structure, copies default Dockerfile, and creates `DOCKER_FLAGS.txt` and `DOCKER_RUN_FLAGS.txt`.
 - `scripts/migrate.sh` — Migrates config files from old shell script location to new `~/.code-container/configs/`.
 - `scripts/cleanup.sh` — Removes old config files from project root after migration.
 
@@ -95,9 +95,10 @@ All user data stored in `~/.code-container/`:
 │   ├── .local/
 │   └── .opencode/
 ├── Dockerfile        # Custom Dockerfile
-├── MOUNTS.txt        # Additional mount points
-├── DOCKER_FLAGS.txt  # Additional docker run flags
-└── settings.json     # Internal settings
+├── MOUNTS.txt              # Additional mount points
+├── DOCKER_FLAGS.txt        # Docker flags for both run and exec
+├── DOCKER_RUN_FLAGS.txt    # Docker flags for run only
+└── settings.json           # Internal settings
 ```
 
 ## CLI Commands

README.md

@@ -119,16 +119,22 @@ RUN apt-get update && apt-get install -y postgresql-client redis-tools
 /absolute/path/on/host:/path/in/container:ro
 ```
 
-**Adding Docker flags**: Edit `~/.code-container/DOCKER_FLAGS.txt` to pass additional flags to `docker run`:
+**Adding Docker flags**:
+
+Edit `~/.code-container/DOCKER_FLAGS.txt` to pass additional flags to both `docker run` and `docker exec`:
+
+```
+# Environment variables
+-e MY_VAR=value
+```
+
+For flags that only apply to `docker run` (e.g. port forwarding, network, GPU), use `~/.code-container/DOCKER_RUN_FLAGS.txt`:
 
 ```
 # Port forwarding
 -p 4040:4040
 -p 3000:3000
 
-# Network mode
---network host
-
 # GPU support
 --gpus all
 ```

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "code-container",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Manage isolated Docker containers for running coding tools on different projects",
   "main": "dist/main.js",
   "bin": {
@@ -19,12 +19,6 @@
     "publish-latest": "npm run clean && npm run build && npm publish",
     "publish-nightly": "npm run clean && npm run build && npm publish --tag nightly"
   },
-  "keywords": [
-    "docker",
-    "container",
-    "development",
-    "cli"
-  ],
   "author": "kevinMEH",
   "license": "MIT",
   "repository": {
@@ -41,5 +35,25 @@
     "@types/shell-quote": "^1.7.5",
     "shell-quote": "^1.7.4",
     "zod": "^4.3.6"
-  }
+  },
+  "keywords": [
+    "docker",
+    "container",
+    "development",
+    "cli",
+    "opencode",
+    "open code",
+    "claude code",
+    "claude",
+    "codex",
+    "openai",
+    "anthropic",
+    "chatbot",
+    "harness",
+    "vibe coding",
+    "gemini",
+    "gemini cli",
+    "copilot",
+    "github copilot"
+  ]
 }

package.json

@@ -8,6 +8,7 @@ const APPDATA_DIR = path.join(os.homedir(), ".code-container");
 const CONFIGS_DIR = path.join(APPDATA_DIR, "configs");
 const DOCKERFILE_PATH = path.join(APPDATA_DIR, "Dockerfile");
 const FLAGS_PATH = path.join(APPDATA_DIR, "DOCKER_FLAGS.txt");
+const RUN_FLAGS_PATH = path.join(APPDATA_DIR, "DOCKER_RUN_FLAGS.txt");
 const PACKAGED_DOCKERFILE = path.join(__dirname, "..", "Dockerfile");
 
 if (!fs.existsSync(APPDATA_DIR)) {
@@ -23,5 +24,9 @@ if (!fs.existsSync(DOCKERFILE_PATH)) {
 }
 
 if (!fs.existsSync(FLAGS_PATH)) {
-  fs.writeFileSync(FLAGS_PATH, "# Add custom Docker flags here (one per line)\n# Note: These flags are passed to every created container.\n");
+  fs.writeFileSync(FLAGS_PATH, "# Add custom Docker flags here (one per line)\n# Note: These flags are passed to every created container and every exec session.\n# Use DOCKER_RUN_FLAGS.txt for flags that only apply to 'docker run'.\n");
+}
+
+if (!fs.existsSync(RUN_FLAGS_PATH)) {
+  fs.writeFileSync(RUN_FLAGS_PATH, "# Add Docker run-only flags here (one per line)\n# Note: These flags are only passed to 'docker run', not 'docker exec'.\n# Use this for flags like -v, --network, --restart that are not valid for exec.\n");
 }

scripts/postinstall.js

@@ -9,6 +9,7 @@ export const DOCKERFILE_PATH = path.join(APPDATA_DIR, "Dockerfile");
 export const SETTINGS_PATH = path.join(APPDATA_DIR, "settings.json");
 export const MOUNTS_PATH = path.join(APPDATA_DIR, "MOUNTS.txt");
 export const FLAGS_PATH = path.join(APPDATA_DIR, "DOCKER_FLAGS.txt");
+export const RUN_FLAGS_PATH = path.join(APPDATA_DIR, "DOCKER_RUN_FLAGS.txt");
 
 export const SHARED_DIRS = [
   ".claude",

src/config.ts

@@ -5,7 +5,7 @@ import * as crypto from "crypto";
 import { printInfo, printError } from "./utils";
 import { APPDATA_DIR, DOCKERFILE_PATH } from "./config";
 import { loadMounts } from "./mounts";
-import { loadFlags } from "./flags";
+import { loadFlags, loadRunFlags } from "./flags";
 
 export const IMAGE_NAME = "code-container";
 export const IMAGE_TAG = "latest";
@@ -113,14 +113,17 @@ export function createNewContainer(
   const args = ["run", "-d", "--name", containerName];
 
   args.push("-e", "TERM=xterm-256color");
+  args.push("-e", "COLORTERM=truecolor");
   args.push("-w", `/root/${projectName}`);
 
   for (const mount of mounts) {
     args.push("-v", mount);
   }
 
   const flags = loadFlags();
+  const runFlags = loadRunFlags();
   args.push(...flags);
+  args.push(...runFlags);
   args.push(...cliFlags);
 
   args.push(`${IMAGE_NAME}:${IMAGE_TAG}`, "sleep", "infinity");
@@ -133,15 +136,19 @@ export function execInteractive(
   containerName: string,
   projectName: string
 ): void {
+  const flags = loadFlags();
   spawnSync(
     "docker",
     [
       "exec",
       "-it",
       "-e",
       "TERM=xterm-256color",
+      "-e",
+      "COLORTERM=truecolor",
       "-w",
       `/root/${projectName}`,
+      ...flags,
       containerName,
       "/bin/bash",
     ],

src/docker.ts

@@ -1,7 +1,7 @@
 import * as fs from "fs";
 import { parse } from "shell-quote";
 
-import { FLAGS_PATH } from "./config";
+import { FLAGS_PATH, RUN_FLAGS_PATH } from "./config";
 import { printError } from "./utils";
 
 export function loadFlags(): string[] {
@@ -41,3 +41,41 @@ export function loadFlags(): string[] {
 
   return flags;
 }
+
+export function loadRunFlags(): string[] {
+  if (!fs.existsSync(RUN_FLAGS_PATH)) {
+    return [];
+  }
+  const content = fs.readFileSync(RUN_FLAGS_PATH, "utf-8");
+  const flags: string[] = [];
+
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) {
+      continue;
+    }
+
+    const parts = parse(trimmed);
+    const lineFlags: string[] = [];
+    let hasOperator = false;
+
+    for (const part of parts) {
+      if (typeof part === "string") {
+        lineFlags.push(part);
+      } else {
+        hasOperator = true;
+        break;
+      }
+    }
+
+    if (hasOperator) {
+      printError("Invalid Docker flag line: shell operators are not allowed.");
+      printError(`Argument skipped: ${line}`);
+      continue;
+    }
+
+    flags.push(...lineFlags);
+  }
+
+  return flags;
+}