coban 0.2.1 → 0.3.0

package/README.md

@@ -57,6 +57,27 @@ npm install -g coban
 cd ~/your-project && coban
 ```
 
+### First run
+
+On first start coban writes `~/.config/coban/config.json` and only offers what it finds: `claude`, `codex`,
+`opencode` and `cursor-agent` that are on your `PATH`. A plain `claude` login (`~/.claude`) becomes profile `h1`.
+Add more Claude accounts with `coban account add` (run it while the app is closed): it opens `claude` for the next
+free profile (`h2`, `h3`...) in its own `~/.claude-hesapN` dir, you log in in the browser and type `/exit`, and the
+profile is written to the config. Restart coban to see it. Edit the file any time, see Config below.
+
+Note: the prompts coban gives the orchestrator and workers, and `coban --help`, are currently in Turkish.
+
+### Troubleshooting
+
+| symptom | fix |
+|---|---|
+| `SyntaxError` / `ERR_UNKNOWN_FILE_EXTENSION` on start | Node is too old, check `node -v` (needs ≥ 24) |
+| agent panel opens but asks to log in | log in once with that CLI (`claude`, `codex`...) outside coban, using the same `CLAUDE_CONFIG_DIR` as the profile |
+| a profile is missing | its CLI is not on `PATH` when coban first ran: install it and delete the config file, or add the profile by hand |
+| `coban çalışmıyor` from a `coban ...` command | open the TUI first with plain `coban`: those commands talk to the running app |
+| stale socket after a crash | `rm ~/.coban/coban.sock` |
+| Codex cannot talk to coban | its sandbox may block the unix socket, see Known gaps |
+
 ### From source (development)
 
 In a clone, TypeScript runs directly with no build step:

package/dist/cli.js

@@ -1,5 +1,7 @@
 import net from 'node:net';
-import { loadConfig, SOCK } from './config.js';
+import fs from 'node:fs';
+import { spawnSync } from 'node:child_process';
+import { appendProfile, CONFIG_PATH, loadConfig, nextAccount, SOCK } from './config.js';
 import { repoMap, snippets } from './context.js';
 import { allUsage } from './usage.js';
 const HELP = `coban — çok hesaplı agent orkestratörü
@@ -24,6 +26,7 @@ Agent'ların içinden (veya başka bir terminalden):
   coban board [--limit n]             ortak kutunun son notları
   coban usage                         hesap kullanımı (5s %, 7g token, reset), en az harcayan başta
   coban log [--limit n]
+  coban account add                   yeni Claude hesabı ekle: giriş yaptırır, profili config'e yazar (arayüz kapalıyken)
 
 Her komut --json ile ham çıktı verir.`;
 function call(method, params) {
@@ -74,6 +77,28 @@ async function main() {
     const [cmd, ...rest] = process.argv.slice(2);
     const { pos, flags, ctx } = parse(rest);
     const num = (v) => (v === undefined || v === true ? undefined : Number(v));
+    if (cmd === 'account') {
+        if (pos[0] !== 'add') {
+            console.log('kullanım: coban account add');
+            process.exit(1);
+        }
+        const cfg = loadConfig();
+        const { profile, dir } = nextAccount(cfg);
+        fs.mkdirSync(dir, { recursive: true });
+        console.log(`Yeni hesap: ${profile.id} (${dir})\nClaude açılıyor: tarayıcıdan giriş yap, sonra /exit yaz.\n`);
+        const r = spawnSync('claude', [], { stdio: 'inherit', env: { ...process.env, CLAUDE_CONFIG_DIR: dir } });
+        if (r.error) {
+            console.error('claude bulunamadı: önce Claude Code kur (https://claude.com/claude-code)');
+            process.exit(1);
+        }
+        if (!fs.readdirSync(dir).length) {
+            console.error('Giriş yapılmamış görünüyor, profil eklenmedi. Tekrar dene: coban account add');
+            process.exit(1);
+        }
+        appendProfile(profile);
+        console.log(`\n${profile.id} eklendi (${CONFIG_PATH}). Arayüzü yeniden aç: coban`);
+        return;
+    }
     if (!cmd || cmd === '--cwd') {
         if (cmd === '--cwd')
             process.chdir(rest[0]);

package/dist/config.js

@@ -20,6 +20,47 @@ const claude = (n, model, color) => ({
     env: { CLAUDE_CONFIG_DIR: `~/.claude-hesap${n}` },
     color,
 });
+const COLORS = ['#F6D5C8', '#FFD9A0', '#C8E6C9', '#FFC8DD', '#BDE0FE', '#E2CFEA'];
+// `coban account add`: the next free hN, its config dir, and a profile ready to append to the config file.
+export function nextAccount(cfg) {
+    const used = new Set(cfg.profiles.map((p) => p.id));
+    let n = 1;
+    while (used.has(`h${n}`))
+        n++;
+    return { profile: claude(n, SONNET, COLORS[(n - 1) % COLORS.length]), dir: path.join(os.homedir(), `.claude-hesap${n}`) };
+}
+export function appendProfile(p) {
+    const raw = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8')); // raw file: keep `~` paths unexpanded
+    raw.profiles.push(p);
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(raw, null, 2) + '\n');
+}
+const onPath = (bin) => (process.env.PATH ?? '').split(path.delimiter).some((d) => d && fs.existsSync(path.join(d, bin)));
+// First run on a fresh machine: only offer what is actually installed. A single `claude` login (~/.claude) becomes
+// h1; extra accounts (h2, h3) appear only when their own config dir (~/.claude-hesapN) already exists.
+export function detectConfig() {
+    const profiles = [];
+    if (onPath('claude')) {
+        const h1 = claude(1, OPUS, '#F6D5C8');
+        if (!fs.existsSync(path.join(os.homedir(), '.claude-hesap1')))
+            delete h1.env;
+        profiles.push(h1);
+        for (const n of [2, 3]) {
+            if (fs.existsSync(path.join(os.homedir(), `.claude-hesap${n}`)))
+                profiles.push(claude(n, SONNET, n === 2 ? '#FFD9A0' : '#C8E6C9'));
+        }
+    }
+    for (const p of DEFAULT_CONFIG.profiles) {
+        if (!p.id.match(/^h\d$/) && onPath(p.cmd.split(' ')[0]))
+            profiles.push(p);
+    }
+    if (!profiles.length)
+        return DEFAULT_CONFIG; // nothing found: keep the full template to edit
+    const orchestrator = profiles[0].id;
+    const cfg = { ...DEFAULT_CONFIG, orchestrator, profiles };
+    if (!/^h\d$/.test(orchestrator))
+        delete cfg.orchestratorModel; // the Sonnet override is a Claude model id
+    return cfg;
+}
 export const DEFAULT_CONFIG = {
     orchestrator: 'h1',
     // Coordination is mostly reading and routing, so the orchestrator runs on Sonnet;
@@ -38,7 +79,7 @@ const expand = (v) => v.replace(/^~(?=\/|$)/, os.homedir());
 export function loadConfig() {
     if (!fs.existsSync(CONFIG_PATH)) {
         fs.mkdirSync(path.dirname(CONFIG_PATH), { recursive: true });
-        fs.writeFileSync(CONFIG_PATH, JSON.stringify(DEFAULT_CONFIG, null, 2) + '\n');
+        fs.writeFileSync(CONFIG_PATH, JSON.stringify(detectConfig(), null, 2) + '\n');
     }
     const cfg = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8'));
     for (const p of cfg.profiles) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coban",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "A terminal app where one orchestrator agent dispatches work to many AI coding agents — several Claude Code accounts, Codex, OpenCode, Cursor — that message each other over a shared board.",
   "scripts": {
     "postinstall": "node -e \"for(const a of ['darwin-arm64','darwin-x64','linux-x64','linux-arm64']){try{require('fs').chmodSync(require.resolve('node-pty/package.json').replace('package.json','prebuilds/'+a+'/spawn-helper'),0o755)}catch{}}\"",