coban 0.2.1 → 0.2.2

package/README.md

@@ -57,6 +57,26 @@ 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`.
+More Claude accounts appear as `h2`/`h3` when `~/.claude-hesap2` / `~/.claude-hesap3` exist (log in with
+`CLAUDE_CONFIG_DIR=~/.claude-hesap2 claude`). 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/config.js

@@ -20,6 +20,33 @@ const claude = (n, model, color) => ({
     env: { CLAUDE_CONFIG_DIR: `~/.claude-hesap${n}` },
     color,
 });
+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 +65,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.2.2",
   "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{}}\"",