@tsuzuku/arise 0.2.0 → 0.3.0

package/README.md

@@ -6,6 +6,7 @@ Unified, workplace-agnostic Git worktree and Herdr workspace orchestrator with p
 
 ## Features
 
+- **Interactive TUI Mode**: Run `arise` with zero arguments for an interactive menu (create worktrees, switch/open existing sessions, list worktrees with Herdr status, nuke/cleanup with multi-picker, and install AI agent skills).
 - **Unified Lifecycle**: Handles git worktree creation, branch resolution, Herdr workspace orchestration, 4-pane quadrant terminal setup, and safe teardown/nuke.
 - **Pluggable Presets**: Built-in support for **Node.js** (`npm`/`yarn`/`pnpm`), **Laravel/PHP** (`composer`, logs, permissions), and **Generic** projects.
 - **Zero-Config Auto-Detection**: Automatically detects project types based on directory markers (`package.json`, `composer.json`, `artisan`, etc.).
@@ -21,7 +22,7 @@ Unified, workplace-agnostic Git worktree and Herdr workspace orchestrator with p
 npm install -g arise
 
 # Or run directly without installing via npx
-npx arise --branch <branch-name>
+npx arise
 ```
 
 Aliases provided: `arise`, `herdr-worktree`, `herder-worktree`, and `hwk`.
@@ -30,7 +31,29 @@ Aliases provided: `arise`, `herdr-worktree`, `herder-worktree`, and `hwk`.
 
 ## Quick Start
 
-### 1. Create a Worktree Session
+### 1. Interactive Setup Wizard (`arise init`)
+```bash
+# Run interactive configuration wizard (Quick or Guided Step-by-Step, with .gitignore prompt)
+arise init
+
+# Fast-path quick initialization with detected repo defaults (optionally adding to .gitignore)
+arise init --quick
+arise init --quick --gitignore
+```
+
+### 2. Interactive Menu / TUI Mode (Zero Arguments)
+```bash
+# Launch interactive menu
+arise
+```
+Interactive options include:
+- 🚀 **Create new worktree** (select base source branch, enter branch name)
+- 🔄 **Switch / Open existing worktree in Herdr**
+- 📋 **List worktrees** (with active Herdr workspace status)
+- 🧹 **Nuke / Cleanup worktree** (multi-select / picker with branch deletion options)
+- ⚙️ **Initialize / Configure Arise** (interactive setup wizard)
+
+### 2. Create a Worktree Session (CLI Flags)
 ```bash
 # Auto-detects project type (Node, Laravel, etc.)
 arise --branch feature/login
@@ -46,7 +69,7 @@ arise --branch feature/login -a aider
 arise --branch feature/login --source develop --focus claude
 ```
 
-### 2. Nuke / Clean Up a Worktree
+### 3. Nuke / Clean Up a Worktree
 ```bash
 # Inside a worktree directory (auto-detects current worktree):
 arise --nuke
@@ -61,7 +84,7 @@ arise --nuke feature-login --dir-only
 arise --nuke feature-login --keep-remote
 ```
 
-### 3. Install AI Agent Skill (Antigravity `agy`, Claude Code, etc.)
+### 4. Install AI Agent Skill (Antigravity `agy`, Claude Code, etc.)
 ```bash
 # Install globally to ~/.agents/skills and link to ~/.gemini/skills:
 arise --install-skill
@@ -108,6 +131,7 @@ arise/
 │   └── cli.js             # Executable CLI
 ├── lib/
 │   ├── cli.js             # CLI argument parsing & help output
+│   ├── interactive.js     # Interactive TUI menu & prompt handlers
 │   ├── config.js          # Config discovery & preset merging
 │   ├── git.js             # Git worktree & branch operations
 │   ├── herdr.js           # Herdr workspace & pane operations

package/index.js

@@ -3,9 +3,11 @@ const { parseArgs, showUsage } = require('./lib/cli');
 const { resolveConfiguration } = require('./lib/config');
 const { executeCreate } = require('./lib/lifecycle/create');
 const { executeNuke } = require('./lib/lifecycle/nuke');
+const logger = require('./lib/logger');
 
 async function run(argv = process.argv.slice(2), cwd = process.cwd()) {
   const flags = parseArgs(argv);
+  logger.initLogger(flags);
 
   if (flags.showHelp) {
     showUsage();
@@ -17,18 +19,54 @@ async function run(argv = process.argv.slice(2), cwd = process.cwd()) {
     process.exit(0);
   }
 
-  if (flags.installSkill) {
-    const { installSkill } = require('./lib/skill');
-    installSkill({ scope: flags.skillScope, cwd });
-    process.exit(0);
-  }
+  try {
+    if (flags.installSkill) {
+      const { installSkill } = require('./lib/skill');
+      installSkill({ scope: flags.skillScope, cwd });
+      process.exit(0);
+    }
+
+    if (flags.isInit) {
+      const { ConfigInitWizard } = require('./lib/config/init');
+      await ConfigInitWizard.run({
+        quick: flags.quick || flags.yes,
+        local: flags.skillScope === 'local',
+        global: flags.skillScope === 'global' && flags.rawArgs.includes('--global'),
+        targetPath: flags.targetPath,
+        force: flags.force,
+        gitignore: flags.gitignore,
+        cwd,
+      });
+      return;
+    }
+
+    const config = resolveConfiguration(flags, cwd);
+    logger.debug(`Loaded configuration for cwd="${cwd}":`, {
+      configFile: config.configFile,
+      preset: config.preset?.name,
+      layoutCount: config.layout?.length,
+      panes: config.layout?.map((p) => ({ id: p.id, title: p.title, from: p.from, split: p.split })),
+    });
+
+    if (flags.isCleanup) {
+      await executeNuke(flags, config, cwd);
+      return;
+    }
 
-  const config = resolveConfiguration(flags, cwd);
+    // Interactive CLI / TUI Mode (arise with zero args or --interactive flag)
+    const isZeroArgs = flags.rawArgs.length === 0 && !flags.branch;
+    if (flags.interactive || isZeroArgs) {
+      if (process.stdin.isTTY || flags.interactive) {
+        const { startInteractiveMenu } = require('./lib/interactive');
+        await startInteractiveMenu(flags, config, cwd);
+        return;
+      }
+    }
 
-  if (flags.isCleanup) {
-    await executeNuke(flags, config, cwd);
-  } else {
     await executeCreate(flags, config, cwd);
+  } catch (err) {
+    logger.error(`Execution failed: ${err.message}`, err);
+    process.exit(1);
   }
 }
 

package/lib/cli.js

@@ -5,12 +5,22 @@ function showUsage() {
 Arise - Unified Worktree & Herdr Workspace Orchestrator
 
 Usage:
+  arise                                (Interactive menu / TUI mode)
+  arise init [options]                 (Interactive setup wizard / .ariserc.json generator)
   arise --branch <branch> [options]
   arise --nuke [<worktree dir or branch>] [nuke-options]
   arise --cleanup [<worktree dir or branch>] [nuke-options]
 
+Interactive & Wizard Modes:
+  arise                       (Running with zero arguments launches the interactive TUI menu)
+  arise init, --init          Launch the Arise configuration initialization wizard.
+  --quick, -q                 (Wizard option) Fast-path setup with detected repo defaults.
+  --gitignore                 (Wizard option) Add generated config file to .gitignore.
+  --no-gitignore              (Wizard option) Do not add generated config file to .gitignore.
+  --interactive, -I, --menu   Launch interactive prompt/menu (create, switch, list, nuke, init).
+
 Creation Arguments:
-  --branch, -b <branch>       (Required for creation) Git branch to create or boot into.
+  --branch, -b <branch>       (Required for non-interactive creation) Git branch to create or boot into.
   --dirname, -d <dirname>     (Optional) Directory name of the worktree. Defaults to sanitized branch name.
   --workspace, -w <name>      (Optional) Custom Herdr workspace name.
   --source, -s, --base <src>  (Optional) Base branch if creating a new branch. Defaults to preset default (e.g. 'develop' / 'prod').
@@ -33,7 +43,9 @@ Agent Skill Arguments:
   --local, --workspace        Install skill locally to current workspace (.agents/skills).
 
 General Arguments:
-  --yes, -y                   (Optional) Automatically answer yes to confirmation prompts (e.g. installing Herdr).
+  --yes, -y                   (Optional) Automatically answer yes to confirmation prompts (e.g. installing Herdr, quick init).
+  --debug                     (Optional) Enable verbose debug logging to stderr and log file.
+  --verbose, -V               (Optional) Alias for --debug.
   --help, -h                  Show this help message.
   --version, -v               Show version information.
 `);
@@ -41,12 +53,17 @@ General Arguments:
 
 function parseArgs(argv = process.argv.slice(2)) {
   const flags = {
+    interactive: false,
+    isInit: false,
+    quick: false,
     isCleanup: false,
     cleanupTarget: null,
     dirOnly: false,
     keepRemote: false,
     force: false,
     yes: false,
+    debug: false,
+    verbose: false,
     branch: null,
     dirname: null,
     workspaceName: null,
@@ -56,6 +73,8 @@ function parseArgs(argv = process.argv.slice(2)) {
     focusTarget: null,
     installSkill: false,
     skillScope: 'global',
+    targetPath: null,
+    gitignore: null,
     showHelp: false,
     showVersion: false,
     rawArgs: argv,
@@ -68,6 +87,21 @@ function parseArgs(argv = process.argv.slice(2)) {
       flags.showHelp = true;
     } else if (arg === '--version' || arg === '-v') {
       flags.showVersion = true;
+    } else if (arg === '--debug') {
+      flags.debug = true;
+    } else if (arg === '--verbose' || arg === '-V') {
+      flags.verbose = true;
+      flags.debug = true;
+    } else if (arg === 'init' || arg === '--init') {
+      flags.isInit = true;
+    } else if (arg === '--quick' || arg === '-q') {
+      flags.quick = true;
+    } else if (arg === '--gitignore' || arg === '--add-gitignore') {
+      flags.gitignore = true;
+    } else if (arg === '--no-gitignore') {
+      flags.gitignore = false;
+    } else if (arg === '--interactive' || arg === '-I' || arg === '--menu' || arg === 'menu' || arg === 'interactive') {
+      flags.interactive = true;
     } else if (arg === '--install-skill' || arg === '--install-agent-skill' || arg === '--setup-skill' || arg === '-i') {
       flags.installSkill = true;
     } else if (arg === '--global') {
@@ -88,6 +122,9 @@ function parseArgs(argv = process.argv.slice(2)) {
       flags.force = true;
     } else if (arg === '--yes' || arg === '-y') {
       flags.yes = true;
+    } else if (arg === '--target' || arg === '--out') {
+      flags.targetPath = argv[i + 1];
+      i++;
     } else if (arg === '--branch' || arg === '-b') {
       flags.branch = argv[i + 1];
       i++;