agentcage 0.1.4 → 0.1.5

package/README.md

@@ -1,10 +1,10 @@
 # agentcage
 
 ```
- ▄▄▄ ▄▄▄▄ ▄▄▄▄ ▄▄▄▄  █   ▄▄▄▄  ▄▄▄ ▄▄▄▄ ▄▄▄▄
-▄▄▄█ █  █ █▄▄▄ █  █ ▀█▀  █    ▄▄▄█ █  █ █▄▄▄
-█▄▄█ ▀▀▀█ █▄▄▄ █  █  █▄▄ █▄▄▄ █▄▄█ ▀▀▀█ █▄▄▄
-     ▀▀▀▀                          ▀▀▀▀
+ ▄▄▄ ▄▄▄▄ ▄▄▄▄ ▄▄▄▄  █    ▄▄▄▄  ▄▄▄ ▄▄▄▄ ▄▄▄▄
+▄▄▄█ █  █ █▄▄▄ █  █ ▀█▀ • █    ▄▄▄█ █  █ █▄▄▄
+█▄▄█ ▀▀▀█ █▄▄▄ █  █  █▄▄  █▄▄▄ █▄▄█ ▀▀▀█ █▄▄▄
+     ▀▀▀▀                           ▀▀▀▀
 ```
 
 Isolated dev containers for AI coding agents. Each project gets its own Linux container. **The project source lives
@@ -60,8 +60,9 @@ Run `agentcage` .  The wizard will ask you for this:
   API key in your terminal. Additional Providers can be added later. 
 7. **An IDE** to open the container in when it's ready (Cursor, VS Code, Antigravity).
 
-Then it builds the container, adds it to OpenCode Desktop as server **ac-<name>** (a green project) with the project
-`/workspaces/<name>` already open, and opens the IDE.
+Then it builds the container, adds it to OpenCode Desktop as server **ac-&lt;name&gt;** (a green project with a generated
+128x128 icon: `ac` in small letters over the first three letters of the name) with the project `/workspaces/<name>` already
+open, and opens the IDE.
 
 The same works without the dialog:
 
@@ -81,7 +82,7 @@ agentcage start <name>          # start after a reboot, print the OpenCode serve
 agentcage shell <name>          # shell in the container (opencode, claude, git ... work here)
 agentcage open <name> [ide]     # Cursor (default), VS Code, or another VS Code-based IDE attached to the container
 agentcage provider <name>       # add model provider API keys to OpenCode in the container
-agentcage connect <name>        # (re)register the container in OpenCode Desktop
+agentcage connect <name>        # (re)register the container in OpenCode Desktop and refresh its project icon
 agentcage upgrade <name>        # rebuild with the Desktop app's OpenCode version (volumes kept)
 agentcage stop <name>
 agentcage remove <name>         # delete container, volumes and config

package/bin/agentcage.js

@@ -4,7 +4,7 @@ import { parseArgs } from 'node:util';
 import * as p from '@clack/prompts';
 import { adoptContainer, listContainers, loadContainer, removeContainer, saveContainer, state, up, writeDevcontainer, openIde, ws } from '../src/container.js';
 import { ask, connectionInfo, newWizard, providerFlow, registerFlow, settingsWizard } from '../src/wizard.js';
-import { detectDesktop, latestVersion } from '../src/opencode.js';
+import { detectDesktop, latestVersion, setupProject } from '../src/opencode.js';
 import { ok, run } from '../src/run.js';
 
 process.removeAllListeners('warning'); // hide node:sqlite ExperimentalWarning
@@ -19,7 +19,7 @@ const HELP = `agentcage: isolated dev containers for AI coding agents
   agentcage stop <name>
   agentcage shell <name>            shell in the container (run opencode, claude, git ... here)
   agentcage open <name> [ide]       open Cursor (default), VS Code or another VS Code-based IDE attached to the container
-  agentcage connect <name>          (re)register the container in OpenCode Desktop (app must be closed)
+  agentcage connect <name>          (re)register the container in OpenCode Desktop and refresh its project icon (app must be closed)
   agentcage provider <name>         add model provider API keys to OpenCode in the container
   agentcage upgrade <name>          rebuild with the Desktop app's OpenCode version (volumes kept)
   agentcage remove <name>           delete container, volumes and config
@@ -73,7 +73,11 @@ const commands = {
     const b = container(); await start(b); openIde(b, arg2 ?? f.ide ?? 'cursor');
     if (b.git === 'token') p.log.warn('The IDE forwards your SSH agent into the container. Turn it off in the IDE settings to keep pushes limited to the repo token (see README).');
   },
-  async connect() { await registerFlow(container()); },
+  async connect() {
+    const b = container();
+    await start(b).then(() => setupProject(b)).catch(e => p.log.warn(`Could not set the project name and icon in OpenCode: ${e.message}`));
+    await registerFlow(b);
+  },
   async provider() { const b = container(); await start(b); await providerFlow(b, csv(f.providers)); },
   async upgrade() {
     const b = container(), v = detectDesktop().version ?? await latestVersion();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentcage",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Isolated dev containers for AI coding agents (OpenCode, Claude Code), connected to OpenCode Desktop",
   "type": "module",
   "bin": {

package/src/icon.js

@@ -0,0 +1,95 @@
+// Generates the 128x128 project icon for OpenCode: dark green background, white text in two rows —
+// the project prefix ("ac") in small letters on top, the first three letters of the container name below.
+// A hand-rolled PNG encoder (zlib + CRC) with a 5x7 bitmap font keeps this dependency-free.
+import { deflateSync } from 'node:zlib';
+
+const SIZE = 128, SS = 4, BG = [20, 83, 45], FG = [255, 255, 255]; // SS: supersampling for smooth edges
+
+// 5x7 pixel font ('#' = ink); lowercase letters, digits and - cover all names and prefixes
+const FONT = {
+  a: ['.....', '.....', '.###.', '....#', '.####', '#...#', '.####'],
+  b: ['#....', '#....', '####.', '#...#', '#...#', '#...#', '####.'],
+  c: ['.....', '.....', '.####', '#....', '#....', '#....', '.####'],
+  d: ['....#', '....#', '.####', '#...#', '#...#', '#...#', '.####'],
+  e: ['.....', '.....', '.###.', '#...#', '#####', '#....', '.###.'],
+  f: ['..##.', '.#...', '####.', '.#...', '.#...', '.#...', '.#...'],
+  g: ['.....', '.....', '.###.', '#...#', '.####', '....#', '.###.'],
+  h: ['#....', '#....', '####.', '#...#', '#...#', '#...#', '#...#'],
+  i: ['..#..', '.....', '..#..', '..#..', '..#..', '..#..', '..#..'],
+  j: ['....#', '.....', '....#', '....#', '....#', '#...#', '.###.'],
+  k: ['#....', '#....', '#...#', '#..#.', '###..', '#..#.', '#...#'],
+  l: ['..#..', '..#..', '..#..', '..#..', '..#..', '..#..', '..#..'],
+  m: ['.....', '.....', '##.##', '#.#.#', '#.#.#', '#.#.#', '#.#.#'],
+  n: ['.....', '.....', '####.', '#...#', '#...#', '#...#', '#...#'],
+  o: ['.....', '.....', '.###.', '#...#', '#...#', '#...#', '.###.'],
+  p: ['.....', '.....', '####.', '#...#', '#...#', '####.', '#....'],
+  q: ['.....', '.....', '.####', '#...#', '#...#', '.####', '....#'],
+  r: ['.....', '.....', '#.##.', '##..#', '#....', '#....', '#....'],
+  s: ['.....', '.....', '.####', '#....', '.###.', '....#', '####.'],
+  t: ['.#...', '.#...', '###..', '.#...', '.#...', '.#...', '.##..'],
+  u: ['.....', '.....', '#...#', '#...#', '#...#', '#...#', '.###.'],
+  v: ['.....', '.....', '#...#', '#...#', '#...#', '.#.#.', '..#..'],
+  w: ['.....', '.....', '#...#', '#...#', '#.#.#', '#.#.#', '.#.#.'],
+  x: ['.....', '.....', '#...#', '.#.#.', '..#..', '.#.#.', '#...#'],
+  y: ['.....', '.....', '#...#', '#...#', '.#.#.', '..#..', '..#..'],
+  z: ['.....', '.....', '####.', '...#.', '..#..', '.#...', '####.'],
+  0: ['.###.', '#...#', '#..##', '#.#.#', '##..#', '#...#', '.###.'],
+  1: ['..#..', '.##..', '..#..', '..#..', '..#..', '..#..', '.###.'],
+  2: ['.###.', '#...#', '....#', '...#.', '..#..', '.#...', '#####'],
+  3: ['.###.', '#...#', '....#', '..##.', '....#', '#...#', '.###.'],
+  4: ['...#.', '..##.', '.#.#.', '#..#.', '#####', '...#.', '...#.'],
+  5: ['#####', '#....', '####.', '....#', '....#', '#...#', '.###.'],
+  6: ['.###.', '#....', '#....', '####.', '#...#', '#...#', '.###.'],
+  7: ['#####', '....#', '...#.', '..#..', '..#..', '..#..', '..#..'],
+  8: ['.###.', '#...#', '#...#', '.###.', '#...#', '#...#', '.###.'],
+  9: ['.###.', '#...#', '#...#', '.####', '....#', '....#', '.###.'],
+  '-': ['.....', '.....', '.....', '.###.', '.....', '.....', '.....'],
+};
+
+const crcTable = Array.from({ length: 256 }, (_, n) => { let c = n; for (let k = 0; k < 8; k++) c = c & 1 ? 0xEDB88320 ^ (c >>> 1) : c >>> 1; return c; });
+const crc32 = buf => { let c = -1; for (const b of buf) c = crcTable[(c ^ b) & 255] ^ (c >>> 8); return (c ^ -1) >>> 0; };
+const chunk = (type, data) => { const t = Buffer.from(type), head = Buffer.alloc(8), crc = Buffer.alloc(4);
+  head.writeUInt32BE(data.length); t.copy(head, 4); crc.writeUInt32BE(crc32(Buffer.concat([t, data])));
+  return Buffer.concat([head, data, crc]); };
+
+const png = rgba => {
+  const ihdr = Buffer.alloc(13), stride = SIZE * 4, raw = Buffer.alloc((stride + 1) * SIZE);
+  ihdr.writeUInt32BE(SIZE); ihdr.writeUInt32BE(SIZE, 4); ihdr[8] = 8; ihdr[9] = 6; // 8-bit RGBA
+  for (let y = 0; y < SIZE; y++) rgba.copy(raw, y * (stride + 1) + 1, y * stride, (y + 1) * stride);
+  return Buffer.concat([Buffer.from('89504e470d0a1a0a', 'hex'), chunk('IHDR', ihdr), chunk('IDAT', deflateSync(raw)), chunk('IEND', Buffer.alloc(0))]);
+};
+
+// Draws one text row centered horizontally; s and y are in final-image pixels (rendered at SS x)
+const draw = (img, dim, text, s, y) => {
+  let x = Math.round((SIZE - (text.length * 6 - 1) * s) / 2) * SS;
+  for (const ch of text) {
+    const g = FONT[ch];
+    if (g) for (let r = 0; r < 7; r++) for (let c = 0; c < 5; c++) if (g[r][c] === '#')
+      for (let dy = 0; dy < s * SS; dy++) for (let dx = 0; dx < s * SS; dx++) {
+        const i = ((y * SS + r * s * SS + dy) * dim + x + c * s * SS + dx) * 3;
+        img[i] = FG[0]; img[i + 1] = FG[1]; img[i + 2] = FG[2];
+      }
+    x += 6 * s * SS;
+  }
+};
+
+// The icon as a data URL for OpenCode's project icon override
+export const projectIcon = (name, prefix = 'ac') => {
+  const dim = SIZE * SS, img = Buffer.alloc(dim * dim * 3);
+  for (let i = 0; i < dim * dim; i++) { img[i * 3] = BG[0]; img[i * 3 + 1] = BG[1]; img[i * 3 + 2] = BG[2]; }
+  const rows = [[prefix.replace(/[^a-z0-9]/g, ''), 3], [name.slice(0, 3), 6]].filter(([t]) => t);
+  const gap = 12, total = rows.reduce((n, [, s]) => n + 7 * s, 0) + gap * (rows.length - 1);
+  let y = Math.round((SIZE - total) / 2);
+  for (const [t, s] of rows) { draw(img, dim, t, s, y); y += 7 * s + gap; }
+  const out = Buffer.alloc(SIZE * SIZE * 4); // downsample SS x SS blocks for smooth edges
+  for (let py = 0; py < SIZE; py++) for (let px = 0; px < SIZE; px++) {
+    let r = 0, g = 0, b = 0;
+    for (let dy = 0; dy < SS; dy++) for (let dx = 0; dx < SS; dx++) {
+      const i = ((py * SS + dy) * dim + px * SS + dx) * 3;
+      r += img[i]; g += img[i + 1]; b += img[i + 2];
+    }
+    const o = (py * SIZE + px) * 4, n = SS * SS;
+    out[o] = Math.round(r / n); out[o + 1] = Math.round(g / n); out[o + 2] = Math.round(b / n); out[o + 3] = 255;
+  }
+  return `data:image/png;base64,${png(out).toString('base64')}`;
+};

package/src/opencode.js

@@ -2,6 +2,7 @@
 import { copyFileSync, existsSync, readFileSync, readdirSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
+import { projectIcon } from './icon.js';
 import { ok, run, runSync } from './run.js';
 import { loadSettings } from './settings.js';
 
@@ -55,7 +56,7 @@ export async function connectDesktop(container) {
 // Names stored at creation; containers made before the settings existed use the current settings
 export const serverName = c => c.serverName ?? loadSettings().serverPrefix + c.name;
 
-// Sets the project's name and icon color in the container's OpenCode server. Asking about the folder creates the project first.
+// Sets the project's name and its generated icon in the container's OpenCode server. Asking about the folder creates the project first.
 // The server starts in the background after `devcontainer up`, so retry for ~30 s.
 export async function setupProject(c) {
   const s = loadSettings(), name = c.projectName ?? s.projectPrefix + c.name, color = c.color ?? s.color;
@@ -66,7 +67,7 @@ export async function setupProject(c) {
     try {
       await api(`/vcs?location[directory]=${encodeURIComponent(dir)}`);
       const { id } = (await api('/project')).find(x => x.canonical === dir);
-      return await api(`/project/${id}`, { method: 'PATCH', body: JSON.stringify({ name, icon: { color } }) });
+      return await api(`/project/${id}`, { method: 'PATCH', body: JSON.stringify({ name, icon: { color, override: projectIcon(c.name, s.projectPrefix) } }) });
     } catch (e) { if (i >= 15) throw e; await new Promise(r => setTimeout(r, 2000)); }
   }
 }

package/src/wizard.js

@@ -135,7 +135,7 @@ export async function newWizard(f = {}) {
     process.exit(1);
   }
   if (providers.length) await providerFlow(b, providers);
-  if (oc) await setupProject(b).catch(e => p.log.warn(`Could not set the project name and color in OpenCode: ${e.message}`));
+  if (oc) await setupProject(b).catch(e => p.log.warn(`Could not set the project name and icon in OpenCode: ${e.message}`));
   if (oc) await registerFlow(b, !f.yes);
   if (ide !== 'none') { openIde(b, ide); p.log.success('Opening the IDE attached to the container'); }
   p.outro([