agentcage 0.1.6 → 0.1.7

package/README.md

@@ -106,6 +106,7 @@ created afterwards.
 | Docker container prefix | `ac-` | container and volume names, e.g. `ac-myproject`, `ac-myproject-src` |
 | OpenCode server prefix | `ac-` | the server's name in OpenCode Desktop |
 | OpenCode project prefix | `ac-` | the project's name in OpenCode (the folder stays `/workspaces/<name>`) |
+| Git token per project | `don't use` | `ask every time` asks token or forwarded credentials for each new container, `always use` always asks for a token. See [Git push access](#git-push-access) |
 
 **Clean up dead containers** (also in Settings) lists leftovers of containers that no longer exist in Docker: agentcage
 configs and OpenCode Desktop servers. Stopped containers are kept. A config whose volumes still hold code is not
@@ -113,7 +114,7 @@ preselected, because removing it deletes those volumes.
 
 ## Git push access
 
-The copy in the container is separate from your laptop's, so changes leave the container via **git push**. The dialog offers two ways:
+The copy in the container is separate from your laptop's, so changes leave the container via **git push**. There are two ways. By default no token is used and the dialog doesn't ask; the **Git token per project** setting changes that:
 
 - **A token for this repo only (recommended).** The dialog shows how to create one: a fine-grained GitHub token limited to
 the repo with *Contents: read and write*, a GitLab project access token, or a Bitbucket repository access token. The token

package/bin/agentcage.js

@@ -85,6 +85,7 @@ const commands = {
     b.opencodeVersion = v; writeDevcontainer(b);
     await up(b, true).then(() => s.stop(`Rebuilt with OpenCode ${v}`), e => { s.error('Rebuild failed'); throw e; });
     saveContainer(b);
+    if (b.tools.includes('opencode')) await setupProject(b).catch(e => p.log.warn(`Could not set the project name and icon in OpenCode: ${e.message}`));
   },
   async remove() {
     const b = container();

package/package.json

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

package/src/icon.js

@@ -1,11 +1,14 @@
 // 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.
+// the project prefix ("ac") in small letters on top, the first three letters of the container name in capitals below —
+// and a light color band along the bottom, its hue picked from the name (looks random, stays the same per project).
 // 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 BAND = 4; // bottom pixel rows in the accent color
+
+// 5x7 pixel font ('#' = ink); lowercase and capital letters, digits and - cover all names and prefixes
 const FONT = {
   a: ['.....', '.....', '.###.', '....#', '.####', '#...#', '.####'],
   b: ['#....', '#....', '####.', '#...#', '#...#', '#...#', '####.'],
@@ -44,6 +47,39 @@ const FONT = {
   8: ['.###.', '#...#', '#...#', '.###.', '#...#', '#...#', '.###.'],
   9: ['.###.', '#...#', '#...#', '.####', '....#', '....#', '.###.'],
   '-': ['.....', '.....', '.....', '.###.', '.....', '.....', '.....'],
+  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: ['#####', '....#', '...#.', '..#..', '.#...', '#....', '#####'],
+};
+
+// Light accent color with a hue from the name, HSL(hue, 75%, 72%). Greens (hue 80-160) are skipped: no contrast with the background
+const accent = name => {
+  const h = (160 + [...name].reduce((n, ch) => (n * 31 + ch.charCodeAt(0)) >>> 0, 7) % 280) % 360, s = 0.75, l = 0.72;
+  const f = k => { const a = s * Math.min(l, 1 - l), t = (k + h / 30) % 12; return Math.round(255 * (l - a * Math.max(-1, Math.min(t - 3, 9 - t, 1)))); };
+  return [f(0), f(8), f(4)];
 };
 
 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; });
@@ -76,10 +112,11 @@ const draw = (img, dim, text, s, y) => {
 // 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 band = accent(name);
+  for (let i = 0; i < dim * dim; i++) { const c = i >= dim * (SIZE - BAND) * SS ? band : BG; img[i * 3] = c[0]; img[i * 3 + 1] = c[1]; img[i * 3 + 2] = c[2]; }
+  const rows = [[prefix.replace(/[^a-z0-9]/g, ''), 3], [name.slice(0, 3).toUpperCase(), 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);
+  let y = Math.round((SIZE - BAND - total) / 2) - 4; // centered above the band, then nudged up
   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++) {

package/src/settings.js

@@ -6,10 +6,16 @@ import { join } from 'node:path';
 const FILE = join(homedir(), '.agentcage', 'settings.json');
 // Project icon colors OpenCode Desktop can show (others render as gray). green first: our default, gray: OpenCode's.
 export const COLORS = ['green', 'gray', 'pink', 'blue', 'red', 'purple', 'yellow', 'orange', 'cyan'];
-export const DEFAULTS = { color: 'green', containerPrefix: 'ac-', serverPrefix: 'ac-', projectPrefix: 'ac-' };
+export const DEFAULTS = { color: 'green', containerPrefix: 'ac-', serverPrefix: 'ac-', projectPrefix: 'ac-', gitToken: 'never' };
 export const LABELS = {
   color: 'OpenCode project color', containerPrefix: 'Docker container prefix',
   serverPrefix: 'OpenCode server prefix', projectPrefix: 'OpenCode project prefix',
+  gitToken: 'Git token per project (GitHub, GitLab, Bitbucket)',
+};
+// Settings with fixed choices ({ value: label }); the others are free-text prefixes
+export const CHOICES = {
+  color: Object.fromEntries(COLORS.map(c => [c, c === 'gray' ? "gray (OpenCode's default)" : c])),
+  gitToken: { never: "don't use (push with the IDE's forwarded credentials)", ask: 'ask every time', always: 'always use' },
 };
 
 export const loadSettings = () => ({ ...DEFAULTS, ...(existsSync(FILE) && JSON.parse(readFileSync(FILE, 'utf8'))) });

package/src/wizard.js

@@ -7,7 +7,7 @@ import { cleanName, createContainer, listContainers, nameTaken, openIde, publish
 import { isGitUrl, localRemote, parseRemote } from './git.js';
 import { connectDesktop, desktopRunning, desktopServers, detectDesktop, latestVersion, loginProvider, removeDesktopServers, serverName, setupProject } from './opencode.js';
 import { ok, runSync } from './run.js';
-import { COLORS, DEFAULTS, LABELS, loadSettings, saveSettings } from './settings.js';
+import { CHOICES, DEFAULTS, LABELS, loadSettings, saveSettings } from './settings.js';
 
 export const ask = async q => {
   const v = await q;
@@ -112,13 +112,17 @@ export async function newWizard(f = {}) {
   const remoteUrl = isGitUrl(src) ? src : localRemote(src), remote = parseRemote(remoteUrl);
   let git = 'none', token;
   if (remote) {
-    git = await pick(f.git, 'forward', () => ask(p.select({ message: `How should the container push to ${remote.host}/${remote.path}?`, options: [
+    // The gitToken setting decides whether to ask (never / always skip the question); --git overrides it
+    const fixed = f.git ?? { never: 'forward', always: 'token' }[s.gitToken];
+    git = await pick(fixed, 'forward', () => ask(p.select({ message: `How should the container push to ${remote.host}/${remote.path}?`, options: [
       { value: 'token', label: 'A token for this repo only', hint: 'recommended: agents can only push here' },
       { value: 'forward', label: "Skip: use my IDE's forwarded credentials", hint: 'access to all your repos while the IDE is attached' },
     ] })));
     if (git === 'token') {
       p.note(hostInfo(remote.host).help(remote.path), 'Repo token');
       token = process.env.AGENTCAGE_GIT_TOKEN ?? await ask(p.password({ message: 'Paste the token', validate: v => (v ? undefined : 'Required') }));
+    } else if (fixed && !f.git) {
+      p.log.info(`Git push: your IDE's forwarded credentials, no repo token (change in: agentcage settings)`);
     } else if (!f.yes) {
       p.note(FORWARD_WARNING, 'Warning: cross-repo access');
       if (!(await ask(p.confirm({ message: 'Continue with forwarded credentials?', initialValue: false })))) return newWizard({ ...f, src, name });
@@ -176,12 +180,12 @@ export async function settingsWizard() {
   const s = loadSettings();
   for (;;) {
     const key = await ask(p.select({ message: 'Which setting? (applies to new containers)', options: [
-      ...Object.keys(DEFAULTS).map(k => ({ value: k, label: LABELS[k], hint: s[k] === '' ? 'none' : s[k] })),
+      ...Object.keys(DEFAULTS).map(k => ({ value: k, label: LABELS[k], hint: s[k] === '' ? 'none' : CHOICES[k]?.[s[k]] ?? s[k] })),
       { value: '-cleanup', label: 'Clean up dead containers', hint: 'configs and OpenCode servers whose container is gone' }, { value: '', label: 'Done' }] }));
     if (!key) break;
     if (key === '-cleanup') { await cleanupFlow(); continue; }
-    s[key] = await ask(key === 'color'
-      ? p.select({ message: LABELS.color, initialValue: s.color, options: COLORS.map(c => ({ value: c, label: c, hint: c === 'gray' ? "OpenCode's default" : undefined })) })
+    s[key] = await ask(CHOICES[key]
+      ? p.select({ message: LABELS[key], initialValue: s[key], options: Object.entries(CHOICES[key]).map(([value, label]) => ({ value, label })) })
       : p.text({ message: `${LABELS[key]} (empty for none)`, initialValue: s[key], defaultValue: '', validate: v => (/^[a-z0-9-]*$/.test(v ?? '') ? undefined : 'Use lowercase letters, digits and -') }));
     saveSettings(s);
   }