@stilero/bankan 1.0.3 → 1.0.5

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="docs/images/ban_kan_logo_readme.svg" alt="Ban Kan logo" width="520" />
+  <img src="https://raw.githubusercontent.com/stilero/bankan/HEAD/docs/images/ban_kan_logo_readme.svg" alt="Ban Kan logo" width="520" />
 </p>
 
 # Ban Kan
@@ -21,7 +21,7 @@ Bring order to parallel AI development without leaving your local workflow.
 </p>
 
 <p align="center">
-  <img src="docs/images/bankan_screenshot.png" alt="Ban Kan dashboard showing backlog, planning, implementation, review, and done columns" width="1200" />
+  <img src="https://raw.githubusercontent.com/stilero/bankan/HEAD/docs/images/bankan_screenshot.png" alt="Ban Kan dashboard showing backlog, planning, implementation, review, and done columns" width="1200" />
 </p>
 
 <p align="center">
@@ -38,6 +38,73 @@ Bring order to parallel AI development without leaving your local workflow.
 
 ---
 
+## Installation
+
+### Run instantly
+
+```bash
+npx @stilero/bankan
+```
+
+### Install globally
+
+```bash
+npm install -g @stilero/bankan
+bankan
+```
+
+### Run from source
+
+```bash
+git clone https://github.com/stilero/bankan.git
+cd bankan
+
+npm run install:all
+npm run setup
+npm run dev
+```
+
+Ban Kan starts a local server, opens your browser automatically, and serves the dashboard from the same process.
+
+---
+
+## Requirements
+
+- Node.js >= 18
+- git
+- One AI CLI tool:
+  - claude
+  - codex
+
+Native build tools may be needed only if `node-pty` has to compile during install.
+
+macOS: Xcode Command Line Tools  
+Linux: build-essential
+
+---
+
+## Quick Start
+
+1. Launch Ban Kan
+
+```bash
+bankan
+```
+
+2. Complete the setup wizard
+
+3. Add one or more repositories in `Settings -> General -> Repositories`
+
+4. Create a task in the dashboard
+
+5. Approve the generated plan
+
+6. Watch agents implement and review the change
+
+7. Optionally create a pull request
+
+---
+
 ## What Is Ban Kan
 
 Ban Kan is a **local control center for AI coding agents** that work across real repositories.
@@ -79,14 +146,14 @@ Each stage has a clear responsibility, and tasks move forward only when the prev
 <table>
   <tr>
     <td align="center" width="50%">
-      <img src="docs/images/before_claude_windows.png" alt="Four separate Claude Code terminal windows used to coordinate parallel agent work before Ban Kan" width="100%" />
+      <img src="https://raw.githubusercontent.com/stilero/bankan/HEAD/docs/images/before_claude_windows.png" alt="Four separate Claude Code terminal windows used to coordinate parallel agent work before Ban Kan" width="100%" />
       <br />
       <strong>Before Ban Kan</strong>
       <br />
       Managing multiple agents means juggling separate terminal windows and fragmented context.
     </td>
     <td align="center" width="50%">
-      <img src="docs/images/bankan_multi_tasks.png" alt="Ban Kan dashboard showing multiple tasks and agent output in one coordinated interface" width="100%" />
+      <img src="https://raw.githubusercontent.com/stilero/bankan/HEAD/docs/images/bankan_multi_tasks.png" alt="Ban Kan dashboard showing multiple tasks and agent output in one coordinated interface" width="100%" />
       <br />
       <strong>With Ban Kan</strong>
       <br />
@@ -133,7 +200,7 @@ Below is the same task moving through Ban Kan's workflow from creation to comple
 ### 1. Create the task
 
 <p align="center">
-  <img src="docs/images/workflow/add_task.png" alt="Ban Kan add task modal used to create the Stripe payments task" />
+  <img src="https://raw.githubusercontent.com/stilero/bankan/HEAD/docs/images/workflow/add_task.png" alt="Ban Kan add task modal used to create the Stripe payments task" />
 </p>
 
 The developer creates a task in the dashboard and defines the story to be planned and executed.
@@ -141,7 +208,7 @@ The developer creates a task in the dashboard and defines the story to be planne
 ### 2. Planning starts
 
 <p align="center">
-  <img src="docs/images/workflow/planning_stage_started.png" alt="Ban Kan planning stage showing the Stripe payments task as planning starts" />
+  <img src="https://raw.githubusercontent.com/stilero/bankan/HEAD/docs/images/workflow/planning_stage_started.png" alt="Ban Kan planning stage showing the Stripe payments task as planning starts" />
 </p>
 
 The planner agent picks up the task, analyzes the repository, and prepares an implementation plan.
@@ -149,7 +216,7 @@ The planner agent picks up the task, analyzes the repository, and prepares an im
 ### 3. Review and approve the plan
 
 <p align="center">
-  <img src="docs/images/workflow/planning_approve_plan.png" alt="Ban Kan planning stage showing an approval-ready plan for the Stripe payments task" />
+  <img src="https://raw.githubusercontent.com/stilero/bankan/HEAD/docs/images/workflow/planning_approve_plan.png" alt="Ban Kan planning stage showing an approval-ready plan for the Stripe payments task" />
 </p>
 
 The generated plan is shown in the dashboard so the developer can approve it before any code is written.
@@ -157,7 +224,7 @@ The generated plan is shown in the dashboard so the developer can approve it bef
 ### 4. Implementation runs
 
 <p align="center">
-  <img src="docs/images/workflow/implementing_task.png" alt="Ban Kan implementation stage showing the Stripe payments task being actively worked on by an agent" />
+  <img src="https://raw.githubusercontent.com/stilero/bankan/HEAD/docs/images/workflow/implementing_task.png" alt="Ban Kan implementation stage showing the Stripe payments task being actively worked on by an agent" />
 </p>
 
 After approval, the implementor agent creates its workspace, writes the code, and reports progress live in the UI.
@@ -165,7 +232,7 @@ After approval, the implementor agent creates its workspace, writes the code, an
 ### 5. Review stage
 
 <p align="center">
-  <img src="docs/images/workflow/review_stage.png" alt="Ban Kan review stage showing the Stripe payments task being validated by a reviewer agent" />
+  <img src="https://raw.githubusercontent.com/stilero/bankan/HEAD/docs/images/workflow/review_stage.png" alt="Ban Kan review stage showing the Stripe payments task being validated by a reviewer agent" />
 </p>
 
 The reviewer agent validates the implementation, checks for issues, and decides whether the task is ready to move forward.
@@ -173,7 +240,7 @@ The reviewer agent validates the implementation, checks for issues, and decides
 ### 6. Done / ready for PR
 
 <p align="center">
-  <img src="docs/images/workflow/done_stage.png" alt="Ban Kan done stage showing the Stripe payments task completed and ready for pull request creation" />
+  <img src="https://raw.githubusercontent.com/stilero/bankan/HEAD/docs/images/workflow/done_stage.png" alt="Ban Kan done stage showing the Stripe payments task completed and ready for pull request creation" />
 </p>
 
 Once review passes, the task moves to Done and can be used as the basis for a pull request.
@@ -182,72 +249,6 @@ Multiple tasks can move through these stages simultaneously with different agent
 
 ---
 
-## Installation
-
-### Run instantly
-
-```bash
-npx @stilero/bankan
-```
-
-### Install globally
-
-```bash
-npm install -g @stilero/bankan
-bankan
-```
-
-### Run from source
-
-```bash
-git clone https://github.com/stilero/bankan.git
-cd bankan
-
-npm run install:all
-npm run setup
-npm run dev
-```
-
-Ban Kan starts a local server, opens your browser automatically, and serves the dashboard from the same process.
-
----
-
-## Requirements
-
-- Node.js >= 18
-- git
-- One AI CLI tool:
-  - claude
-  - codex
-- Native build tools for node-pty
-
-macOS: Xcode Command Line Tools  
-Linux: build-essential
-
----
-
-## Quick Start
-
-1. Launch Ban Kan
-
-```bash
-bankan
-```
-
-2. Complete the setup wizard
-
-3. Add one or more local repositories
-
-4. Create a task in the dashboard
-
-5. Approve the generated plan
-
-6. Watch agents implement and review the change
-
-7. Optionally create a pull request
-
----
-
 ## How It Works
 
 ```mermaid
@@ -339,7 +340,7 @@ Useful scripts:
 
 - `npm run build` – build client bundle
 - `npm run dev` – run server + Vite client
-- `npm run setup` – interactive setup wizard
+- `npm run setup` – interactive setup wizard for agent CLI selection and local runtime config
 - `npm run install:all` – install all dependencies
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stilero/bankan",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "type": "module",
   "description": "Run AI coding agents like a Kanban board. Plan, implement, review and ship code using parallel AI agents across your local repositories.",
   "license": "MIT",

package/scripts/setup.js

@@ -102,20 +102,23 @@ async function main() {
     console.log(`\n  ${red('⚠')} Neither claude nor codex CLI found. At least one is required.\n`);
   }
 
-  // Check native build tools
-  const platform = process.platform;
-  if (platform === 'darwin') {
-    try {
-      execSync('xcode-select -p', { stdio: 'pipe' });
-      console.log(`  ${green('✓')} Xcode command line tools`);
-    } catch {
-      console.log(`  ${yellow('⚠')} Xcode CLI tools missing ${dim('(xcode-select --install)')}`);
-    }
-  } else if (platform === 'linux') {
-    if (checkCommand('cc')) {
-      console.log(`  ${green('✓')} C compiler`);
-    } else {
-      console.log(`  ${yellow('⚠')} C compiler missing ${dim('(apt install build-essential)')}`);
+  if (!IS_PACKAGED_RUNTIME) {
+    console.log(`  ${dim('Note: native build tools may be needed if npm has to compile node-pty during install.')}`);
+
+    const platform = process.platform;
+    if (platform === 'darwin') {
+      try {
+        execSync('xcode-select -p', { stdio: 'pipe' });
+        console.log(`  ${green('✓')} Xcode command line tools available`);
+      } catch {
+        console.log(`  ${yellow('⚠')} Xcode CLI tools not found ${dim('(only needed if node-pty builds from source: xcode-select --install)')}`);
+      }
+    } else if (platform === 'linux') {
+      if (checkCommand('cc')) {
+        console.log(`  ${green('✓')} C compiler available`);
+      } else {
+        console.log(`  ${yellow('⚠')} C compiler not found ${dim('(only needed if node-pty builds from source: apt install build-essential)')}`);
+      }
     }
   }
 
@@ -127,36 +130,11 @@ async function main() {
 
   // Step 3: Project Config
   console.log(bold('  Project Configuration\n'));
-
-  const reposHint = existing.REPOS ? dim(` (${existing.REPOS}), Enter to keep`) : '';
-  const reposAnswer = await ask(`  REPOS (comma-separated git repo paths)${reposHint}: `);
-  if (reposAnswer.trim()) {
-    config.REPOS = reposAnswer.trim();
-  }
-
-  if (config.REPOS) {
-    const repoPaths = config.REPOS.split(',').map(s => s.trim()).filter(Boolean);
-    for (const repoPath of repoPaths) {
-      try {
-        execSync(`git -C "${repoPath}" rev-parse HEAD`, { stdio: 'pipe' });
-        console.log(`  ${green('✓')} ${repoPath} — valid git repo`);
-      } catch {
-        console.log(`  ${yellow('⚠')} ${repoPath} — not a git repo or no commits yet`);
-      }
-    }
-  }
-
-  const ghRepoHint = existing.GITHUB_REPO ? dim(` (${existing.GITHUB_REPO}), Enter to keep`) : dim(' (optional, owner/repo)');
-  const ghRepoAnswer = await ask(`  GITHUB_REPO${ghRepoHint}: `);
-  if (ghRepoAnswer.trim()) config.GITHUB_REPO = ghRepoAnswer.trim();
-
-  const ghTokenHint = existing.GITHUB_TOKEN ? dim(' (already set, Enter to keep)') : dim(' (optional)');
-  const ghTokenAnswer = await ask(`  GITHUB_TOKEN${ghTokenHint}: `);
-  if (ghTokenAnswer.trim()) config.GITHUB_TOKEN = ghTokenAnswer.trim();
-
+  console.log(`  ${dim('Repositories are configured in the app under Settings → General → Repositories.')}`);
+  console.log(`  ${dim('Use the workspace folder in Settings to choose where task workspaces are created.')}`);
   console.log('');
 
-  // Step 5: Agent Config
+  // Step 4: Agent Config
   console.log(bold('  Agent Configuration\n'));
 
   const imp1Default = existing.IMPLEMENTOR_1_CLI || 'claude';
@@ -171,12 +149,9 @@ async function main() {
 
   console.log('');
 
-  // Step 6: Write .env.local
+  // Step 5: Write .env.local
   mkdirSync(runtimePaths.dataDir, { recursive: true });
   const envLines = [
-    `REPOS=${config.REPOS || ''}`,
-    `GITHUB_REPO=${config.GITHUB_REPO || ''}`,
-    `GITHUB_TOKEN=${config.GITHUB_TOKEN || ''}`,
     `IMPLEMENTOR_1_CLI=${config.IMPLEMENTOR_1_CLI || 'claude'}`,
     `IMPLEMENTOR_2_CLI=${config.IMPLEMENTOR_2_CLI || 'codex'}`,
     `PORT=${config.PORT}`,
@@ -193,7 +168,7 @@ async function main() {
     return;
   }
 
-  // Step 7: Install Dependencies
+  // Step 6: Install Dependencies
   console.log(bold('  Installing dependencies...\n'));
 
   const installSteps = [
@@ -212,7 +187,7 @@ async function main() {
     }
   }
 
-  // Step 8: Success
+  // Step 7: Success
   console.log('');
   console.log(green(bold('  ✓ Setup complete!')));
   console.log('');
@@ -220,6 +195,7 @@ async function main() {
   console.log(cyan('    npm start'));
   console.log('');
   console.log(`  Then open: ${cyan('http://localhost:5173')}`);
+  console.log(`  Configure repositories in ${cyan('Settings → General → Repositories')}.`);
   console.log('');
 
   rl.close();