Release/v2.1.1 (#19)

* AGENTS.md: Update instructions

* postinstall.js: Change DOCKER_FLAGS.txt content

* Add ability to pass flags to `container run`

* v2.1.1

Author: kevinMEH

AGENTS.md

@@ -1,4 +1,4 @@
-**Important: Role Identification:** Identify whether your user is a **developer** or a **consumer**.
+**Important: You must perform user identification.** Identify whether your user is a **developer** or a **consumer**.
 
 If your user asks questions like:
 - Help me setup `container` / code-container / this project
@@ -102,6 +102,7 @@ All user data stored in `~/.code-container/`:
 ## CLI Commands
 
 - `container [path]` — Run container for project (`commands.ts:runContainer`)
+- `container run [path] [-- DOCKER_FLAGS]` — Run container with optional Docker flags
 - `container build` — Build Docker image (`commands.ts:buildImage`)
 - `container init` — Initialize config files (`commands.ts:init`)
 - `container stop` — Stop container (`commands.ts:stopContainerForProject`)

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "code-container",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Manage isolated Docker containers for running coding tools on different projects",
   "main": "dist/main.js",
   "bin": {

package.json

@@ -23,5 +23,5 @@ if (!fs.existsSync(DOCKERFILE_PATH)) {
 }
 
 if (!fs.existsSync(FLAGS_PATH)) {
-  fs.writeFileSync(FLAGS_PATH, "# Add custom Docker flags here (one per line)\n# Example: -p 7777:7777\n");
+  fs.writeFileSync(FLAGS_PATH, "# Add custom Docker flags here (one per line)\n# Note: These flags are passed to every created container.\n");
 }

scripts/postinstall.js

@@ -87,7 +87,7 @@ export async function init(isStartup: boolean = false): Promise<void> {
   }
 }
 
-export async function runContainer(projectPath: string): Promise<void> {
+export async function runContainer(projectPath: string, cliFlags: string[] = []): Promise<void> {
   const containerName = generateContainerName(projectPath);
   const projectName = path.basename(projectPath);
 
@@ -124,7 +124,7 @@ export async function runContainer(projectPath: string): Promise<void> {
   printInfo(`Creating new container: ${containerName}`);
   printInfo(`Project: ${projectPath}`);
 
-  if (!createNewContainer(containerName, projectName, projectPath)) {
+  if (!createNewContainer(containerName, projectName, projectPath, cliFlags)) {
     printError("Failed to create container");
     process.exit(1);
   }

src/commands.ts

@@ -106,7 +106,8 @@ export function removeContainer(containerName: string): void {
 export function createNewContainer(
   containerName: string,
   projectName: string,
-  projectPath: string
+  projectPath: string,
+  cliFlags: string[] = []
 ): boolean {
   const mounts = getMounts(projectPath, projectName);
   const args = ["run", "-d", "--name", containerName];
@@ -120,6 +121,7 @@ export function createNewContainer(
 
   const flags = loadFlags();
   args.push(...flags);
+  args.push(...cliFlags);
 
   args.push(`${IMAGE_NAME}:${IMAGE_TAG}`, "sleep", "infinity");
 

src/docker.ts

@@ -57,7 +57,7 @@ async function ensureTosAccepted(): Promise<boolean> {
 
 function usage(): void {
   console.log(`
-Usage: container [COMMAND] [PROJECT_PATH]
+Usage: container [COMMAND] [PROJECT_PATH] [-- DOCKER_FLAGS...]
 
 Manage Code containers for isolated project environments.
 
@@ -73,10 +73,13 @@ Commands:
 
 Arguments:
     PROJECT_PATH    Path to the project directory (defaults to current directory)
+    DOCKER_FLAGS    Additional flags passed to 'docker run' after '--'
 
 Examples:
     container                           # Start container for current directory
     container run /path/to/project      # Start container for specific project
+    container run /path -- -p 8080:80   # Pass Docker flags for port mapping
+    container run -- -e FOO=bar         # Pass env vars (uses current directory)
     container build                     # Build Docker image
     container init                      # Copy config files
     container stop                      # Stop container for current directory
@@ -91,6 +94,7 @@ async function main(): Promise<void> {
   const args = process.argv.slice(2);
   let command = "";
   let projectPath = "";
+  let cliFlags: string[] = [];
 
   if (args.length > 0) {
     const firstArg = args[0];
@@ -109,12 +113,23 @@ async function main(): Promise<void> {
     ];
     if (validCommands.includes(firstArg)) {
       command = firstArg;
-      if (args.length > 1) {
-        projectPath = args[1];
-      }
-      if (args.length > 2) {
-        printError(`Unexpected argument: ${args[2]}`);
-        usage();
+      const remainingArgs = args.slice(1);
+      const separatorIndex = remainingArgs.indexOf("--");
+      
+      if (separatorIndex !== -1) {
+        const pathArgs = remainingArgs.slice(0, separatorIndex);
+        if (pathArgs.length > 1) {
+          printError(`Unexpected argument: ${pathArgs[1]}`);
+          usage();
+        }
+        projectPath = pathArgs[0] || "";
+        cliFlags = remainingArgs.slice(separatorIndex + 1);
+      } else {
+        projectPath = remainingArgs[0] || "";
+        if (remainingArgs.length > 1) {
+          printError(`Unexpected argument: ${remainingArgs[1]}`);
+          usage();
+        }
       }
     } else {
       printError(`Unknown command: ${firstArg}`);
@@ -156,7 +171,7 @@ async function main(): Promise<void> {
       return;
     case "run":
     case "":
-      await runContainer(resolvedPath);
+      await runContainer(resolvedPath, cliFlags);
       return;
   }
 }