@ycs77/devbox 0.2.0 → 0.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 # @ycs77/devbox
 
-**An AI-first, containerized development environment.**
+**A containerized devbox for AI agents.**
 
 [![NPM version][ico-version]][link-npm]
 [![Software License][ico-license]](LICENSE)
@@ -17,13 +17,13 @@ English | [繁體中文](README-zh-TW.md)
 
 ## Overview
 
-Devbox gives each project an isolated Docker sandbox with Lucas's opinionated development setup. Choose a Node.js version and the AI agents you use, then work from a consistent environment without configuring containers yourself.
+Devbox gives each project an isolated Docker sandbox designed for AI agents, with Lucas's opinionated development setup. Choose the Node.js release lines and AI agents you use, then work from a consistent container without configuring it yourself.
 
 ## Features
 
-- **AI-first workspace:** built for AI-assisted development, with Claude Code, Codex, and more available during setup.
-- **Simple project lifecycle:** initialize, start, enter, stop, and remove a sandbox with a few commands.
-- **Fast Node.js switching:** configure Node.js 22 and 24, then select a version for each project.
+- **Container environment for AI agents:** choose Claude Code, Codex, and more during setup, then use them inside the sandbox.
+- **Simple setup and project lifecycle:** initialize, start, enter, stop, and remove a sandbox with a few commands.
+- **Flexible Node.js environments:** configure Node.js 22 and 24, then select a version for each project.
 - **Selective builds:** build only the Node.js versions and AI agents you choose.
 - **No project configuration files:** keep Devbox configuration local to your machine, not in your repository.
 

package/dist/cli.mjs

@@ -1,5 +1,7 @@
-import { cac } from "cac";
 import * as p from "@clack/prompts";
+import { intro, outro } from "@clack/prompts";
+import { cac } from "cac";
+import c from "picocolors";
 import { createHash, randomUUID } from "node:crypto";
 import { lstat, mkdir, readFile, rename, rm, rmdir, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
@@ -744,7 +746,7 @@ async function initializeProjectUnlocked(input = {}) {
 			confirmed: true
 		});
 	}
-	if (!await (input.confirm ?? input.prompt?.confirm ?? (async () => true))(`Register Project ${projectRoot} and write its configuration?`)) return success({
+	if (!await (input.confirm ?? input.prompt?.confirm ?? (async () => true))("Save configuration?")) return success({
 		root: projectRoot,
 		stateDirectory,
 		sandboxName: name,
@@ -828,11 +830,13 @@ async function configureLocalProjectUnlocked(input = {}) {
 		root: projectRoot,
 		changed: false
 	});
-	const confirm = input.confirm ?? input.prompt?.confirm ?? (async () => true);
-	const changeSummary = `Current: ${serializeLocalConfiguration(localCheck.value).trim()}\nNext: ${serializeLocalConfiguration(nextCheck.value).trim()}`;
-	if (!await confirm(`Save Local configuration for ${projectRoot}?`, {
-		title: "Local configuration changes",
-		content: changeSummary
+	if (!await (input.confirm ?? input.prompt?.confirm ?? (async () => true))("Save Project configuration?", {
+		title: "Review configuration",
+		sections: [{
+			title: `Project: ${projectRoot}`,
+			current: serializeLocalConfiguration(localCheck.value).trim(),
+			next: serializeLocalConfiguration(nextCheck.value).trim()
+		}]
 	})) return success({
 		scope: "local",
 		root: projectRoot,
@@ -926,15 +930,17 @@ async function configureGlobalUnlocked(input = {}, locks) {
 		scope: "global",
 		changed: false
 	});
-	const confirm = input.confirm ?? input.prompt?.confirm ?? (async () => true);
-	const localChangeSummary = [...replacementConfigurations].map(([root, configuration]) => `Project ${root}:\nCurrent: ${serializeLocalConfiguration(localConfigurations.get(root)).trim()}\nNext: ${serializeLocalConfiguration(configuration).trim()}`).join("\n\n");
-	if (!await confirm("Save Global configuration?", {
-		title: "Global configuration changes",
-		content: [
-			`Current Global:\n${serializeGlobalConfiguration(currentConfiguration).trim()}`,
-			`Next Global:\n${serializeGlobalConfiguration(nextCheck.value).trim()}`,
-			localChangeSummary
-		].filter(Boolean).join("\n\n")
+	if (!await (input.confirm ?? input.prompt?.confirm ?? (async () => true))("Save Global configuration?", {
+		title: "Review configuration",
+		sections: [{
+			title: "Global configuration",
+			current: serializeGlobalConfiguration(currentConfiguration).trim(),
+			next: serializeGlobalConfiguration(nextCheck.value).trim()
+		}, ...[...replacementConfigurations].map(([root, configuration]) => ({
+			title: `Project: ${root}`,
+			current: serializeLocalConfiguration(localConfigurations.get(root)).trim(),
+			next: serializeLocalConfiguration(configuration).trim()
+		}))]
 	})) return success({
 		scope: "global",
 		changed: false
@@ -1467,7 +1473,7 @@ function createConfigurationPrompter({ signal, input, output }) {
 	};
 	return {
 		confirm: async (message, details) => {
-			if (details !== void 0) p.note(details.content, details.title, common);
+			if (details !== void 0) p.note(renderConfirmationDetails(details), c.bold(c.cyan(details.title)), common);
 			return promptValue(p.confirm({
 				message,
 				...common
@@ -1485,6 +1491,7 @@ function createConfigurationPrompter({ signal, input, output }) {
 			...common
 		})),
 		editGlobal: async (configuration, catalog) => {
+			p.log.step(`${c.bold(c.cyan("Global configuration"))}\n${c.dim("Choose the runtimes and agents available to every Project.")}`, common);
 			return {
 				version: 1,
 				node: await promptValue(p.multiselect({
@@ -1509,6 +1516,7 @@ function createConfigurationPrompter({ signal, input, output }) {
 			};
 		},
 		editLocal: async (configuration, catalog, globalConfiguration) => {
+			p.log.step(`${c.bold(c.cyan("Project configuration"))}\n${c.dim("Choose the runtime for this Project.")}`, common);
 			return {
 				version: 1,
 				node: await promptValue(p.select({
@@ -1527,13 +1535,69 @@ function createConfigurationPrompter({ signal, input, output }) {
 		}
 	};
 }
+function renderConfirmationDetails(details) {
+	return details.sections.map((section) => [
+		c.bold(section.title),
+		`${c.yellow(c.dim("Current"))}\n${section.current}`,
+		`${c.bold(c.green("New"))}\n${section.next}`
+	].join("\n\n")).join("\n\n");
+}
 async function promptValue(prompt) {
 	const value = await prompt;
 	if (p.isCancel(value)) throw new InterruptedError();
 	return value;
 }
 //#endregion
+//#region src/logo.ts
+const ASCII_ART = [
+	"██████╗ ███████╗██╗   ██╗██████╗  ██████╗ ██╗  ██╗",
+	"██╔══██╗██╔════╝██║   ██║██╔══██╗██╔═══██╗╚██╗██╔╝",
+	"██║  ██║█████╗  ██║   ██║██████╔╝██║   ██║ ╚███╔╝ ",
+	"██║  ██║██╔══╝  ╚██╗ ██╔╝██╔══██╗██║   ██║ ██╔██╗ ",
+	"██████╔╝███████╗ ╚████╔╝ ██████╔╝╚██████╔╝██╔╝ ██╗",
+	"╚═════╝ ╚══════╝  ╚═══╝  ╚═════╝  ╚═════╝ ╚═╝  ╚═╝"
+];
+const COLORS = [
+	`\x1B[38;5;51m`,
+	`\x1B[38;5;45m`,
+	`\x1B[38;5;39m`,
+	`\x1B[38;5;32m`,
+	`\x1B[38;5;25m`,
+	`\x1B[38;5;26m`
+];
+const REST = "\x1B[0m";
+function showLogo() {
+	for (let i = 0; i < ASCII_ART.length; i++) console.log(`${COLORS[i]}${ASCII_ART[i]}${REST}`);
+}
+//#endregion
+//#region \0devbox-workspace-image-default:.bash_aliases.mjs
+var _devbox_workspace_image_default__bash_aliases_default = "alias ..='cd ..'\nalias ...='cd ../..'\nalias c='clear'\nalias g='git'\nalias ccc='claude --dangerously-skip-permissions'\nalias ccx='codex --sandbox workspace-write --ask-for-approval never'\nalias ggg='agy --dangerously-skip-permissions'\n\nfunction mkcd() {\n  mkdir \"$1\"\n  cd \"$1\"\n}\n\n# Laravel Artisan\nalias pa='php artisan'\nalias pav='php artisan serve'\nalias pam='php artisan migrate'\nalias pams='php artisan migrate --seed'\nalias pamr='php artisan migrate:rollback'\nalias pamf='php artisan migrate:fresh'\nalias pamfs='php artisan migrate:fresh --seed'\nalias pas='php artisan db:seed'\nalias par='php artisan route:list'\nalias paq='php artisan queue:work'\nalias pah='php artisan horizon'\nalias pat='php artisan tinker'\nalias phpunit='./vendor/bin/phpunit --colors=always'\nalias pu='phpunit'\nalias pest='./vendor/bin/pest --colors=always'\nalias p='pest'\nalias pint='./vendor/bin/pint'\nalias phpstan='./vendor/bin/phpstan analyse --ansi'\nalias rector='./vendor/bin/rector'\n\n# NPM (requires @antfu/ni)\nalias nv='nr dev' # nd exists in @antfu/ni\nalias nb='nr build'\nalias nll='nr lint' # nl is a Linux command\nalias nlf='nr lint --fix'\nalias nf='nr fmt'\nalias nfc='nr fmt --check'\nalias nc='nr check'\nalias nt='nr test'\nalias ntr='nr test --run'\n";
+//#endregion
+//#region \0devbox-workspace-image-default:.claude/settings.json.mjs
+var settings_json_default = "{\n  \"$schema\": \"https://json.schemastore.org/claude-code-settings.json\",\n  \"env\": {\n    \"CLAUDE_CODE_USE_POWERSHELL_TOOL\": \"0\"\n  },\n  \"attribution\": {\n    \"commit\": \"\",\n    \"pr\": \"\"\n  },\n  \"includeGitInstructions\": false,\n  \"autoMemoryEnabled\": false\n}\n";
+//#endregion
+//#region \0devbox-workspace-image-default:.gitconfig.mjs
+var _devbox_workspace_image_default__gitconfig_default = "[core]\n	autocrlf = input\n	fileMode = false\n	pager = less -r\n	quotepath = false\n[init]\n	defaultBranch = main\n[color]\n	diff = auto\n	status = auto\n	branch = auto\n[alias]\n	cf = config\n	cfl = config --list\n	s = status\n	a = add .\n	l = log --oneline --graph\n	la = log --oneline --graph --all\n	last = log -1 HEAD\n	c = commit\n	cm = commit -m\n	ca = commit --amend -m\n	can = commit --amend --no-edit\n	co = checkout\n	cp = cherry-pick\n	b = branch\n	m = merge\n	mnf = merge --no-ff\n	rs = reset\n	rs0h = reset HEAD --hard\n	rs1 = reset HEAD~1\n	rs1h = reset HEAD~1 --hard\n	rb = rebase\n	rbo = rebase --onto\n	rbi = rebase -i\n	rbc = rebase --continue\n	rba = rebase --abort\n	rm = remote\n	r = remote -v\n	ra = remote add\n	rr = remote remove\n	rp = remote prune\n	f = fetch\n	fp = fetch --prune\n	p = push\n	pl = pull\n";
+//#endregion
+//#region \0devbox-workspace-image-default:.omp/agent/config.yml.mjs
+var config_yml_default = "setupVersion: 2\n\n# Basic\nmodelRoles:\n  default: openai-codex/gpt-5.6-terra:high\n  smol: openai-codex/gpt-5.6-luna:high\n  slow: openai-codex/gpt-5.6-sol:max\n  plan: openai-codex/gpt-5.6-sol:max\nsymbolPreset: unicode\n\n# Theme\ntheme:\n  dark: titanium\n  light: light\ncomposer:\n  shape: claude\n\n# Auto QA\ndev:\n  autoqa: false\n  autoqaConsent: denied\n";
+//#endregion
 //#region src/workspace/build.ts
+const BASE_WORKSPACE_IMAGE_DEFAULTS = [{
+	relativePath: ".bash_aliases",
+	content: _devbox_workspace_image_default__bash_aliases_default
+}, {
+	relativePath: ".gitconfig",
+	content: _devbox_workspace_image_default__gitconfig_default
+}];
+const CLAUDE_SETTINGS_DEFAULT = {
+	relativePath: ".claude/settings.json",
+	content: settings_json_default
+};
+const OMP_AGENT_CONFIG_DEFAULT = {
+	relativePath: ".omp/agent/config.yml",
+	content: config_yml_default
+};
 async function buildWorkspace(input = {}) {
 	return withStateLocks({
 		devboxHome: input.devboxHome ?? join(homedir(), ".devbox"),
@@ -1561,22 +1625,29 @@ async function buildWorkspaceUnlocked(input) {
 	const parsedGlobal = parseGlobalConfiguration(globalSource, catalogCheck.value);
 	if (!parsedGlobal.ok) return parsedGlobal;
 	const globalConfiguration = parsedGlobal.value;
+	const agents = globalConfiguration.agent.map((name) => ({
+		name,
+		recipe: PACKAGED_AGENTS[name]
+	}));
+	const buildContextAssets = selectBuildContextAssets(agents);
+	const nodeRuntimes = globalConfiguration.node.map((releaseLine) => PACKAGED_NODE_RECIPES[releaseLine]);
 	const dockerfile = renderBuildDockerfile({
-		nodeRuntimes: globalConfiguration.node.map((releaseLine) => PACKAGED_NODE_RECIPES[releaseLine]),
+		nodeRuntimes,
 		buildNodeRuntime: buildNodeRuntimeRecipe(globalConfiguration),
-		agents: globalConfiguration.agent.map((name) => ({
-			name,
-			recipe: PACKAGED_AGENTS[name]
-		})),
+		agents,
 		skillAgents: globalConfiguration.agent.filter((agent) => PACKAGED_AGENTS[agent]?.supportsSkillInstallation === true)
 	});
-	await rm(paths.buildContext, {
-		recursive: true,
-		force: true
-	});
 	await mkdir(paths.buildContext, { recursive: true });
-	await writeFile(join(paths.buildContext, "Dockerfile"), dockerfile);
-	await writeFile(join(paths.buildContext, ".dockerignore"), "# Machine-owned Workspace build context\n*\n!Dockerfile\n");
+	await seedBuildContextAssets(paths.buildContext, buildContextAssets);
+	await Promise.all([
+		writeFile(join(paths.buildContext, "Dockerfile"), dockerfile),
+		writeFile(join(paths.buildContext, ".dockerignore"), renderDockerignore(buildContextAssets)),
+		writeFile(join(paths.buildContext, "entrypoint.sh"), renderEntrypoint({
+			nodeRuntimes,
+			agents
+		})),
+		writeFile(join(paths.buildContext, "supervisord.conf"), renderSupervisorConfiguration())
+	]);
 	if (input.signal?.aborted) throw new InterruptedError();
 	const buildResult = await (input.executeDockerBuild ?? runDockerBuild)({
 		context: paths.buildContext,
@@ -1635,9 +1706,85 @@ function renderBuildDockerfile(input) {
 		const skillAgentArguments = input.skillAgents.map((agent) => `-a ${agent}`).join(" ");
 		lines.push("# Install Agent Skills", "RUN set -eux \\", "    && mkdir -p /home/devbox/.agents/skills \\", `    && export PATH="${input.buildNodeRuntime.runtimeRoot}/bin:$PATH" \\`, `    && npx -y skills add ycs77/skills -g ${skillAgentArguments} -s '*' -y`, "");
 	}
-	lines.push("USER root");
+	lines.push("USER root", "", "# Copy dotfiles", "COPY .bash_aliases /home/devbox/.bash_aliases", "COPY .gitconfig /home/devbox/.gitconfig", "RUN chown devbox:devbox /home/devbox/.bash_aliases \\", "    && chown devbox:devbox /home/devbox/.gitconfig", "");
+	const hasClaudeCode = input.agents.some((agent) => agent.name === "claude-code");
+	const hasOmp = input.agents.some((agent) => agent.name === "omp");
+	if (hasClaudeCode || hasOmp) {
+		const ownershipCommands = [];
+		lines.push("# Copy AI dotfiles");
+		if (hasClaudeCode) {
+			lines.push("COPY .claude/settings.json /home/devbox/.claude/settings.json");
+			ownershipCommands.push("chown devbox:devbox /home/devbox/.claude/settings.json");
+		}
+		if (hasOmp) {
+			lines.push("COPY .omp/agent/config.yml /home/devbox/.omp/agent/config.yml");
+			ownershipCommands.push("chown devbox:devbox /home/devbox/.omp/agent", "chown devbox:devbox /home/devbox/.omp/agent/config.yml");
+		}
+		lines.push(`RUN ${ownershipCommands.join(" \\\n    && ")}`, "");
+	}
+	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`;
+}
+function renderDockerignore(assets) {
+	const lines = [
+		"# Machine-owned Workspace build context",
+		"*",
+		"!Dockerfile",
+		"!entrypoint.sh",
+		"!supervisord.conf",
+		...assets.map((asset) => `!${asset.relativePath}`)
+	];
+	if (assets.some((asset) => asset.relativePath === ".claude/settings.json")) lines.push("!.claude", "!.claude/settings.json");
+	if (assets.some((asset) => asset.relativePath === ".omp/agent/config.yml")) lines.push("!.omp", "!.omp/agent", "!.omp/agent/config.yml");
 	return `${lines.join("\n")}\n`;
 }
+async function seedBuildContextAssets(buildContext, assets) {
+	await Promise.all(assets.map(async (asset) => {
+		const destination = join(buildContext, asset.relativePath);
+		await mkdir(dirname(destination), { recursive: true });
+		try {
+			await writeFile(destination, asset.content, { flag: "wx" });
+		} catch (error) {
+			if (typeof error !== "object" || error === null || !("code" in error) || error.code !== "EEXIST") throw error;
+		}
+	}));
+}
+function selectBuildContextAssets(agents) {
+	const assets = [...BASE_WORKSPACE_IMAGE_DEFAULTS];
+	if (agents.some((agent) => agent.name === "claude-code")) assets.push(CLAUDE_SETTINGS_DEFAULT);
+	if (agents.some((agent) => agent.name === "omp")) assets.push(OMP_AGENT_CONFIG_DEFAULT);
+	return assets;
+}
+function renderEntrypoint(input) {
+	const lines = [
+		"#!/bin/sh",
+		"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.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`;
+}
+function renderSupervisorConfiguration() {
+	return `${[
+		"[supervisord]",
+		"nodaemon=true",
+		"user=root",
+		"logfile=/var/log/supervisor/supervisord.log",
+		"pidfile=/var/run/supervisord.pid",
+		"",
+		"[program:idle]",
+		"command=/bin/sleep infinity",
+		"autorestart=false",
+		"startsecs=0",
+		"stopsignal=TERM",
+		"stopasgroup=true",
+		"killasgroup=true",
+		"stdout_logfile=/dev/null",
+		"stderr_logfile=/dev/null"
+	].join("\n")}\n`;
+}
 function renderNodeRuntimeStage(recipe) {
 	const keys = recipe.trustedReleaseKeys.map((key) => `      ${key}`).join(" \\\n");
 	return [
@@ -1724,29 +1871,45 @@ function createCli(signal, interactive) {
 	cli.command("").action(() => cli.outputHelp());
 	cli.command("init", "Register the current directory as a Devbox Project.").action(async () => {
 		if (!interactive) return interactiveFailure("devbox init requires an interactive terminal.", "Run devbox init from a TTY before it writes Project state.");
+		console.log();
+		showLogo();
+		console.log();
+		intro(c.bgCyan(" devbox "));
 		const result = await initializeProject({
 			signal,
 			prompt
 		});
 		if (!result.ok) return result;
-		return success({ message: result.value.created ? `Registered Project: ${result.value.root}` : result.value.confirmed === false ? "Project registration was not changed." : `Project is already registered: ${result.value.root}` });
+		if (result.value.confirmed === false) {
+			outro("Project registration was not changed.");
+			return success({});
+		}
+		if (!result.value.created) {
+			outro("Project is already registered.");
+			return success({});
+		}
+		outro(`Next: run ${c.cyan(c.bold("devbox build"))} to prepare your workspace, then ${c.cyan(c.bold("devbox up"))} to start it.`);
+		return success({});
 	});
 	cli.command("config", "Edit Global or Local configuration for the current Project.").action(async () => {
 		if (!interactive) return interactiveFailure("devbox config requires an interactive terminal.", "Run devbox config from a TTY, or edit the supported Global or Local YAML directly.");
+		intro(c.bgCyan(" devbox "));
 		if (await prompt.selectConfigurationScope() === "global") {
 			const result = await configureGlobal({
 				signal,
 				prompt
 			});
 			if (!result.ok) return result;
-			return success({ message: result.value.changed ? "Global configuration updated." : "Global configuration was not changed." });
+			outro(result.value.changed ? "Global configuration updated." : "Global configuration was not changed.");
+			return success({});
 		}
 		const result = await configureLocalProject({
 			signal,
 			prompt
 		});
 		if (!result.ok) return result;
-		return success({ message: result.value.changed ? "Local configuration updated." : "Local configuration was not changed." });
+		outro(result.value.changed ? "Local configuration updated." : "Local configuration was not changed.");
+		return success({});
 	});
 	cli.command("build", "Build the shared Workspace image from Global configuration.").option("--cache, --no-cache", "Use Docker layer cache.", { default: true }).action(async (options = {}) => {
 		const result = await buildWorkspace({

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ycs77/devbox",
-  "version": "0.2.0",
-  "description": "AI-first containerized development environment for Node.js projects",
+  "version": "0.3.0",
+  "description": "A containerized devbox for AI agents",
   "keywords": [
     "agent",
     "agentic",
@@ -35,6 +35,7 @@
   "dependencies": {
     "@clack/prompts": "^1.7.0",
     "cac": "^7.0.0",
+    "picocolors": "^1.1.1",
     "yaml": "^2.9.0"
   },
   "devDependencies": {