cascade-ai 0.2.0 → 0.2.1

package/README.md

@@ -81,7 +81,7 @@ User prompt
 - **Token-by-token streaming** — live output as agents work
 - **Live agent tree** — real-time T1→T2→T3 execution graph in the terminal
 - **Approval prompts** — explicit y/n for destructive tool operations
-- **Provider failover** — auto-switches provider on rate limits (exponential backoff)
+- **Provider failover** — auto-switches provider on rate limits (exponential backoff); automatically re-enables recovered providers on success
 - **Context auto-summarization** — compresses history when the context window fills
 - **Conversation branching** — fork a session to try parallel approaches
 
@@ -163,6 +163,11 @@ cascade run "explain the auth module in this repo"
 
 Cascade loads config from `.cascade/config.json` in your project directory.
 
+> **Prefer the picker over hand-editing config.** Inside the REPL, run `/model`
+> to walk through a three-step interactive picker (provider → tier → model,
+> with an Auto option at every step). The picker writes `.cascade/config.json`
+> for you and hot-swaps the running router — no restart needed.
+
 ```jsonc
 // .cascade/config.json
 {
@@ -332,7 +337,9 @@ Type any of these inside the REPL:
 | `/clear`     | Clear conversation history                    |
 | `/exit`      | Exit Cascade                                  |
 | `/theme <name>` | Switch color theme                         |
-| `/model`     | Show active models per tier                   |
+| `/model`     | Interactive picker — choose provider → tier → model (or Auto) |
+| `/model-info`| Show active models per tier                   |
+| `/models`    | Browse available models grouped by provider   |
 | `/cost`      | Toggle session cost / token usage panel       |
 | `/export [markdown\|json]` | Export session to file             |
 | `/rollback`  | Undo all file changes made in this session    |
@@ -586,7 +593,7 @@ web/
 |--------|---------|
 | ✓ | T1/T2/T3 hierarchical orchestration |
 | ✓ | 6 AI providers + Ollama |
-| ✓ | Provider failover |
+| ✓ | Provider failover with automatic recovery |
 | ✓ | Streaming REPL (ink) |
 | ✓ | Live agent tree visualization |
 | ✓ | AES-256 encrypted keystore |

package/bin/cascade.js

@@ -1,3 +1,3 @@
-#!/usr/bin/env node
-// Cascade AI — Entry point
-import '../dist/cli.js';
+#!/usr/bin/env node
+// Cascade AI — Entry point
+import '../dist/cli.js';

package/completions/cascade.bash

@@ -1,23 +1,23 @@
-#!/usr/bin/env bash
-# Cascade AI — Bash completions
-# Install: source <(cascade completions bash)
-
-_cascade_completions() {
-  local cur="${COMP_WORDS[COMP_CWORD]}"
-  local commands="init doctor update dashboard run --help --version"
-  local flags="--prompt --theme --workspace --no-color"
-  local themes="cascade dark light dracula nord solarized"
-
-  if [[ "${COMP_WORDS[COMP_CWORD-1]}" == "--theme" ]]; then
-    COMPREPLY=($(compgen -W "$themes" -- "$cur"))
-    return
-  fi
-
-  if [[ "$cur" == -* ]]; then
-    COMPREPLY=($(compgen -W "$flags" -- "$cur"))
-  else
-    COMPREPLY=($(compgen -W "$commands" -- "$cur"))
-  fi
-}
-
-complete -F _cascade_completions cascade
+#!/usr/bin/env bash
+# Cascade AI — Bash completions
+# Install: source <(cascade completions bash)
+
+_cascade_completions() {
+  local cur="${COMP_WORDS[COMP_CWORD]}"
+  local commands="init doctor update dashboard run --help --version"
+  local flags="--prompt --theme --workspace --no-color"
+  local themes="cascade dark light dracula nord solarized"
+
+  if [[ "${COMP_WORDS[COMP_CWORD-1]}" == "--theme" ]]; then
+    COMPREPLY=($(compgen -W "$themes" -- "$cur"))
+    return
+  fi
+
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=($(compgen -W "$flags" -- "$cur"))
+  else
+    COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+  fi
+}
+
+complete -F _cascade_completions cascade

package/completions/cascade.fish

@@ -1,20 +1,20 @@
-# Cascade AI — Fish completions
-# Install: cp cascade.fish ~/.config/fish/completions/
-
-# Disable file completions
-complete -c cascade -f
-
-# Commands
-complete -c cascade -n '__fish_use_subcommand' -a init      -d 'Initialize Cascade in a project'
-complete -c cascade -n '__fish_use_subcommand' -a doctor    -d 'Check system configuration'
-complete -c cascade -n '__fish_use_subcommand' -a update    -d 'Update to latest version'
-complete -c cascade -n '__fish_use_subcommand' -a dashboard -d 'Launch the web dashboard'
-complete -c cascade -n '__fish_use_subcommand' -a run       -d 'Run a single prompt and exit'
-
-# Flags
-complete -c cascade -l prompt    -s p -d 'Single prompt' -r
-complete -c cascade -l theme     -s t -d 'Color theme'   -r -a 'cascade dark light dracula nord solarized'
-complete -c cascade -l workspace -s w -d 'Workspace path' -r -F
-complete -c cascade -l version   -s v -d 'Show version'
-complete -c cascade -l help      -s h -d 'Show help'
-complete -c cascade -l no-color        -d 'Disable colors'
+# Cascade AI — Fish completions
+# Install: cp cascade.fish ~/.config/fish/completions/
+
+# Disable file completions
+complete -c cascade -f
+
+# Commands
+complete -c cascade -n '__fish_use_subcommand' -a init      -d 'Initialize Cascade in a project'
+complete -c cascade -n '__fish_use_subcommand' -a doctor    -d 'Check system configuration'
+complete -c cascade -n '__fish_use_subcommand' -a update    -d 'Update to latest version'
+complete -c cascade -n '__fish_use_subcommand' -a dashboard -d 'Launch the web dashboard'
+complete -c cascade -n '__fish_use_subcommand' -a run       -d 'Run a single prompt and exit'
+
+# Flags
+complete -c cascade -l prompt    -s p -d 'Single prompt' -r
+complete -c cascade -l theme     -s t -d 'Color theme'   -r -a 'cascade dark light dracula nord solarized'
+complete -c cascade -l workspace -s w -d 'Workspace path' -r -F
+complete -c cascade -l version   -s v -d 'Show version'
+complete -c cascade -l help      -s h -d 'Show help'
+complete -c cascade -l no-color        -d 'Disable colors'

package/completions/cascade.zsh

@@ -1,32 +1,32 @@
-#compdef cascade
-# Cascade AI — Zsh completions
-# Install: fpath=(~/.config/cascade/completions $fpath)
-
-_cascade() {
-  local context state state_descr line
-  typeset -A opt_args
-
-  _arguments \
-    '(-v --version)'{-v,--version}'[Show version]' \
-    '(-h --help)'{-h,--help}'[Show help]' \
-    '(-p --prompt)'{-p,--prompt}'[Single prompt]:prompt:' \
-    '(-t --theme)'{-t,--theme}'[Color theme]:theme:(cascade dark light dracula nord solarized)' \
-    '(-w --workspace)'{-w,--workspace}'[Workspace path]:path:_files -/' \
-    '1:command:->command' \
-    '*::args:->args'
-
-  case $state in
-    command)
-      local commands=(
-        'init:Initialize Cascade in a project directory'
-        'doctor:Check system configuration'
-        'update:Update to the latest version'
-        'dashboard:Launch the web dashboard'
-        'run:Run a single prompt and exit'
-      )
-      _describe 'cascade commands' commands
-      ;;
-  esac
-}
-
-_cascade "$@"
+#compdef cascade
+# Cascade AI — Zsh completions
+# Install: fpath=(~/.config/cascade/completions $fpath)
+
+_cascade() {
+  local context state state_descr line
+  typeset -A opt_args
+
+  _arguments \
+    '(-v --version)'{-v,--version}'[Show version]' \
+    '(-h --help)'{-h,--help}'[Show help]' \
+    '(-p --prompt)'{-p,--prompt}'[Single prompt]:prompt:' \
+    '(-t --theme)'{-t,--theme}'[Color theme]:theme:(cascade dark light dracula nord solarized)' \
+    '(-w --workspace)'{-w,--workspace}'[Workspace path]:path:_files -/' \
+    '1:command:->command' \
+    '*::args:->args'
+
+  case $state in
+    command)
+      local commands=(
+        'init:Initialize Cascade in a project directory'
+        'doctor:Check system configuration'
+        'update:Update to the latest version'
+        'dashboard:Launch the web dashboard'
+        'run:Run a single prompt and exit'
+      )
+      _describe 'cascade commands' commands
+      ;;
+  esac
+}
+
+_cascade "$@"