@ycs77/devbox 0.3.1 → 0.4.0

package/README.md

@@ -2,7 +2,7 @@
 
 # @ycs77/devbox
 
-**A containerized devbox for AI agents.**
+**A opinionated devbox for AI agents.**
 
 [![NPM version][ico-version]][link-npm]
 [![Software License][ico-license]](LICENSE)
@@ -79,8 +79,7 @@ Run these commands from the initialized project directory:
 | `devbox sh` | Open a Bash shell in the running sandbox. |
 | `devbox stop` | Stop the sandbox and preserve it for a later restart. |
 | `devbox down` | Stop and remove the sandbox container. |
-| `devbox config` | Change the current project's Node.js selection. |
-| `devbox config -g` | Change the globally configured Node.js versions or AI agents. |
+| `devbox config` | Change the globally configured or current project's Node.js selection. |
 
 ## Troubleshooting
 

package/dist/cli.mjs

@@ -45,9 +45,11 @@ const PACKAGED_AGENTS = {
 		},
 		installation: {
 			url: "https://claude.ai/install.sh",
-			shell: "bash"
+			shell: "bash",
+			preInstallCommands: ["echo '{}' > /home/devbox/.claude.json"]
 		},
 		supportsNotifications: true,
+		notificationInstallationCommands: ["claude plugin marketplace add ycs77/claude-code-notifications", "claude plugin install notification-basic-wsl@ycs77-notifications"],
 		supportsSkillInstallation: true
 	},
 	codex: {
@@ -60,7 +62,8 @@ const PACKAGED_AGENTS = {
 			shell: "sh"
 		},
 		supportsNotifications: true,
-		supportsSkillInstallation: true
+		supportsSkillInstallation: true,
+		notificationInstallationCommands: ["codex plugin marketplace add ycs77/codex-notifications", "codex plugin add notification-basic-wsl@ycs77-notifications"]
 	},
 	agy: {
 		home: {
@@ -84,7 +87,8 @@ const PACKAGED_AGENTS = {
 			shell: "sh"
 		},
 		supportsNotifications: true,
-		supportsSkillInstallation: false
+		supportsSkillInstallation: false,
+		notificationInstallationCommands: ["omp plugin marketplace add ycs77/omp-notifications", "omp plugin install notification-basic@ycs77-notifications"]
 	}
 };
 const PACKAGED_RUNTIME_CATALOG = {
@@ -460,6 +464,7 @@ function selectComposeFragments({ selectedNode, configuredAgents, agentNotificat
 function renderProjectCompose(input) {
 	const fragments = selectComposeFragments(input);
 	const environment = {
+		TERM: "xterm-256color",
 		...fragments.node?.environment,
 		...fragments.notification?.environment
 	};
@@ -496,7 +501,7 @@ function renderProjectCompose(input) {
 		},
 		services: { devbox: {
 			image: WORKSPACE_IMAGE,
-			container_name: input.sandboxName,
+			container_name: `devbox-${input.sandboxName}`,
 			working_dir: `/workspace/${input.sandboxName}`,
 			...Object.keys(environment).length === 0 ? {} : { environment },
 			volumes
@@ -521,7 +526,7 @@ function validatesProjectCompose(source, input) {
 		const metadata = definition["x-devbox"];
 		if (metadata.version !== 1 || metadata.project_root !== input.projectRoot || metadata.compose_name !== input.sandboxName || metadata.sandbox_service !== "devbox") return false;
 		const service = definition.services.devbox;
-		if (service.image !== "devbox-workspace:latest" || service.container_name !== input.sandboxName || service.working_dir !== `/workspace/${input.sandboxName}` || "build" in service) return false;
+		if (service.image !== "devbox-workspace:latest" || service.container_name !== `devbox-${input.sandboxName}` || service.working_dir !== `/workspace/${input.sandboxName}` || "build" in service) return false;
 		return input.selectedNode === null && service.environment?.NODE_VERSION === void 0 || input.selectedNode !== null && service.environment?.NODE_VERSION === input.selectedNode;
 	} catch {
 		return false;
@@ -1635,6 +1640,7 @@ async function buildWorkspaceUnlocked(input) {
 		nodeRuntimes,
 		buildNodeRuntime: buildNodeRuntimeRecipe(globalConfiguration),
 		agents,
+		agentNotifications: globalConfiguration.agent_notifications,
 		skillAgents: globalConfiguration.agent.filter((agent) => PACKAGED_AGENTS[agent]?.supportsSkillInstallation === true)
 	});
 	await mkdir(paths.buildContext, { recursive: true });
@@ -1700,7 +1706,10 @@ function renderBuildDockerfile(input) {
 	for (const recipe of input.nodeRuntimes) lines.push(...renderNodeRuntimeStage(recipe));
 	lines.push("WORKDIR /workspace", "USER devbox", "");
 	if (input.buildNodeRuntime !== void 0) lines.push("# Configure pnpm for the non-root Sandbox user", "RUN mkdir -p /home/devbox/.config/pnpm /home/devbox/.pnpm-store \\", "    && printf 'storeDir: /home/devbox/.pnpm-store\\n' > /home/devbox/.config/pnpm/config.yaml \\", "    && chown devbox:devbox /home/devbox/.config/pnpm/config.yaml", "");
-	for (const agent of input.agents) lines.push(`# Install ${agent.name}`, `RUN mkdir -p ${agent.recipe.home.target} \\`, `    && curl -fsSL ${agent.recipe.installation.url} | ${agent.recipe.installation.shell}`, "");
+	for (const agent of input.agents) {
+		const preInstallCommands = agent.recipe.installation.preInstallCommands ?? [];
+		lines.push(`# Install ${agent.name}`, `RUN mkdir -p ${agent.recipe.home.target} \\`, ...preInstallCommands.map((command) => `    && ${command} \\`), `    && curl -fsSL ${agent.recipe.installation.url} | ${agent.recipe.installation.shell}`, "");
+	}
 	if (input.agents.length > 0) lines.push("# Set the PATH to include AI tools", "ENV PATH=\"/home/devbox/.local/bin:${PATH}\"", "");
 	if (input.buildNodeRuntime !== void 0 && input.skillAgents.length > 0) {
 		const skillAgentArguments = input.skillAgents.map((agent) => `-a ${agent}`).join(" ");
@@ -1722,6 +1731,8 @@ function renderBuildDockerfile(input) {
 		}
 		lines.push(`RUN ${ownershipCommands.join(" \\\n    && ")}`, "");
 	}
+	const notificationInstallationCommands = input.agentNotifications ? input.agents.flatMap((agent) => agent.recipe.supportsNotifications ? agent.recipe.notificationInstallationCommands : []) : [];
+	if (notificationInstallationCommands.length > 0) lines.push("# Install Agent Notification Plugins", "USER devbox", "RUN set -eux \\", ...notificationInstallationCommands.map((command, index) => `    && ${command}${index < notificationInstallationCommands.length - 1 ? " \\" : ""}`), "USER root", "");
 	lines.push("COPY entrypoint.sh /usr/local/bin/entrypoint.sh", "COPY supervisord.conf /etc/supervisor/conf.d/supervisord.conf", "RUN chmod +x /usr/local/bin/entrypoint.sh", "", "ENTRYPOINT [\"/usr/local/bin/entrypoint.sh\"]");
 	return `${lines.join("\n")}\n`;
 }
@@ -1761,7 +1772,7 @@ function renderEntrypoint(input) {
 		"set -eu",
 		""
 	];
-	if (input.nodeRuntimes.length > 0) lines.push("# Set the Node.js release line to use", "NODE_VERSION=\"${NODE_VERSION:-}\"", "if [ -n \"$NODE_VERSION\" ]; then", "  case \"$NODE_VERSION\" in", "    *[!0-9]*)", "      echo \"NODE_VERSION must be a numeric release line: $NODE_VERSION\" >&2", "      exit 1", "      ;;", "  esac", "", "  NODE_RUNTIME_ROOT=\"/opt/devbox/runtimes/node/$NODE_VERSION\"", "  if [ ! -x \"$NODE_RUNTIME_ROOT/bin/node\" ]; then", "    echo \"Node.js release line $NODE_VERSION is not installed.\" >&2", "    exit 1", "  fi", "", "  export NODE_RUNTIME_ROOT", "  export PATH=\"$NODE_RUNTIME_ROOT/bin:$PATH\"", "fi", "");
+	if (input.nodeRuntimes.length > 0) lines.push("# Set the Node.js release line to use", "NODE_VERSION=\"${NODE_VERSION:-}\"", "if [ -n \"$NODE_VERSION\" ]; then", "  case \"$NODE_VERSION\" in", "    *[!0-9]*)", "      echo \"NODE_VERSION must be a numeric release line: $NODE_VERSION\" >&2", "      exit 1", "      ;;", "  esac", "", "  NODE_RUNTIME_ROOT=\"/opt/devbox/runtimes/node/$NODE_VERSION\"", "  if [ ! -x \"$NODE_RUNTIME_ROOT/bin/node\" ]; then", "    echo \"Node.js release line $NODE_VERSION is not installed.\" >&2", "    exit 1", "  fi", "", "  if ! grep -q \"# Devbox\" /etc/bash.bashrc; then", "    printf \"\\n# Devbox\\nexport PATH=\\\"$NODE_RUNTIME_ROOT/bin:\\$PATH\\\"\\n\" >> /etc/bash.bashrc", "  fi", "", "  export PATH=\"$NODE_RUNTIME_ROOT/bin:$PATH\"", "fi", "");
 	if (input.agents.some((agent) => agent.name === "agy")) lines.push("# Link shared Agent Skills", "if [ ! -L \"/home/devbox/.gemini/skills\" ]; then", "  ln -sfn /home/devbox/.agents/skills /home/devbox/.gemini/skills", "  chown -h devbox:devbox /home/devbox/.gemini/skills", "fi", "");
 	lines.push("if [ $# -gt 0 ]; then", "  exec gosu devbox \"$@\"", "else", "  exec /usr/bin/supervisord -c /etc/supervisor/conf.d/supervisord.conf", "fi");
 	return `${lines.join("\n")}\n`;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ycs77/devbox",
-  "version": "0.3.1",
-  "description": "A containerized devbox for AI agents",
+  "version": "0.4.0",
+  "description": "A Lucas Yang's opinionated devbox for AI agents",
   "keywords": [
     "agent",
     "agentic",
@@ -40,6 +40,7 @@
   },
   "devDependencies": {
     "@types/node": "^26.2.0",
+    "actionspack": "^0.1.5",
     "bumpp": "^12.2.0",
     "memfs": "^4.68.1",
     "oxfmt": "^0.63.0",
@@ -60,7 +61,8 @@
     "typecheck": "tsc --noEmit",
     "test": "vitest",
     "check": "pnpm lint && pnpm fmt --check && pnpm typecheck && pnpm test --run",
-    "smoke:cli": "node scripts/package-devbox-smoke.mjs",
+    "smoke": "node scripts/package-devbox-smoke.mjs",
+    "update-actions": "actionspack update",
     "release": "bumpp --commit \"Release v%s\""
   }
 }