v2.0.0 - Cosmic Orange

v2.0.0 - Cosmic Orange

Highlights

• Cosmic Orange theme - fresh new color scheme
• Animated mascot - cute cat companion in the header
• Smart task routing - auto-detects complexity
• Improved output formatting with markdown rendering
• Better settings panel - keyboard navigation works immediately

Cosmic Orange Theme

Complete visual overhaul:

• Orange (#ff8700) and gold (#ffaf00) color palette
• Replaces the old cyan/blue scheme
• Applied to logo, borders, highlights, spinners, status indicators
• Command palette selection in orange
• Mode indicators updated

Animated Mascot

A cute cat that lives next to the ASCII logo:

• Blinks, looks around, changes expressions
• Animates every 800ms
• Adds personality to the TUI

Smart Task Routing

zcode now analyzes your input and automatically chooses the best path:

• Chat/greetings -> Quick friendly response
• Questions -> Direct answer, no file changes
• Simple edits -> Immediate execution
• Complex tasks -> Auto-generates plan, then executes

Output Formatting

AI responses now render markdown properly:

• Headers in bold orange
• Inline code highlighted in gold
• Bullet points with orange icons
• Bold text properly rendered
• Numbered lists with dimmed numbers

Commands

Quick:
/do Plan + generate (^D)
/run Full auto (^R)
/ask Quick question (^A)
/fix Debug mode (^F)

Workflow:
/plan, /generate, /diff, /apply, /undo, /retry, /clear

Files:
/open, /close, /files, /search, /read, /tree

Modes:
/mode, /model, /dry-run

Git:
/git, /commit

System:
/help, /settings, /status, /doctor, /version, /reset, /exit

Keyboard Shortcuts

^D /do
^R /run
^P /plan
^G /generate
^Z /undo
^A /ask
^F /fix
F2 Settings
S-Tab Cycle modes
^C Exit

Breaking Changes

• Default mode is now auto (was edit)
• Color scheme changed from cyan to orange
• Mascot added to header (uses ~12 chars width)

v1.6.0 - Command Palette Redesign

v1.6.0 - Command Palette Redesign & Settings Fix

What's New

Redesigned Command Palette

• Clean, categorized command list (Quick, Workflow, Files, Modes, Git, System)
• Keyboard shortcuts displayed inline
• Alias support - type partial names to find commands
• Scrollable list with proper arrow key navigation
• No emojis - clean ASCII symbols only

Fixed Settings Panel

• Keyboard navigation works immediately on open
• Arrow keys control settings without stealing input focus
• Enter toggles values, Esc saves and closes
• No clicking required

Fixed Input Placeholder

• Placeholder text properly hides when typing
• No more overlay issues

Fixed Double Input Bug

• Removed duplicate key handlers causing double character input

Commands

Quick Actions:
/do Plan + generate in one step (^D)
/run Full auto execution (^R)
/ask Quick question (^A)
/fix Debug mode (^F)

Workflow:
/plan Generate plan (^P)
/generate Create changes (^G)
/diff Review changes
/apply Apply changes
/undo Rollback (^Z)

Files:
/open, /close, /files, /search, /read, /tree

Modes:
/mode Switch mode
/model Select AI model
/dry-run Toggle preview mode

Git:
/git Git operations
/commit AI commit message

System:
/help Show commands
/settings Settings panel (F2)
/status Session status
/doctor Health check
/exit Exit (^C)

Keyboard Shortcuts

^D /do
^R /run
^P /plan
^G /generate
^Z /undo
^A /ask
^F /fix
F2 Settings
S-Tab Cycle modes

v1.4.4 - Input Fixes

v1.4.4 Release - Input Fixes

🐛 Bug Fixes

Double Typing Fixed

• Fixed keys: true on textbox causing double character input
• Input now properly captures single keystrokes

Placeholder Overlap Fixed

• Placeholder text now hides immediately on first keystroke
• No more overlapping text while typing

Mode Cycling

• Added backtick (`) as alternative mode switcher
• Shift+Tab should now work on more terminals

---

v1.4.3 Release - Safety & UX Fixes

🛡️ Safety Improvements

Auto Mode Protection

• Added task validation - vague inputs like "hi" are now treated as questions, not file operations
• Added file path filtering - blocks creating files in src/ unless explicitly mentioned in task
• Blocks file operations outside project directory
• Better prompts to prevent model from creating random files

Casual Chat Detection

• Improved greeting detection (hi, hii, hiii, hey, heyyy, yo, etc.)
• Short inputs (≤4 chars) are now properly routed to chat handler
• Auto mode no longer executes file operations for casual chat

🎨 UI Improvements

Big ASCII Logo

• New large "ZAI CODE" ASCII art banner
• Toggle on/off in settings (ASCII Logo setting)

Settings Menu Fixed

• Completely rewritten settings modal with proper keyboard handling
• Added Default Mode setting - choose startup mode (edit/auto/ask/debug/review/explain)
• Added ASCII Logo toggle
• Up/Down/Enter/Escape all work properly now
• Mouse support for clicking options

Command Palette Fixed

• Up/Down arrow navigation now works correctly
• Proper filtering of commands as you type
• Tab completion works with selected item

⚙️ New Settings

• Default Mode - Set which mode zcode starts in (edit, auto, ask, debug, review, explain)
• ASCII Logo - Toggle the big ASCII banner on/off

---

v1.4.2 Release - Core Functionality Fixes

🐛 Critical Bug Fixes

Mode Routing Fixed

• Fixed "hi" and casual chat triggering wrong workflow - now properly routes to chat handler
• Added isCasualChat() detection for greetings, small talk, thanks, etc.
• Added isSimpleQuestion() for short questions that don't need code context
• New 'chat' workflow type for natural conversation

File Creation Fixed

• Fixed auto mode not properly parsing file operations from model responses
• Improved parseFileOperations() to handle various response formats
• Better JSON extraction from markdown code blocks
• Normalized file paths (removes leading ./)

Output Scrolling Fixed

• Added mouse: true, keys: true, vi: true to output log widget
• Chat history is now scrollable with mouse wheel and keyboard

Mode Cycling Added

• Shift+Tab now cycles through modes: edit → auto → ask → debug → review → explain
• Visual feedback when mode changes

Improved Auto Mode

• Better system prompt for file operations with explicit JSON format
• Fallback handling when model doesn't return structured response
• Shows raw output when no file operations detected

---

v1.4.1 Release - UX Fixes

🐛 Bug Fixes

• Fixed command palette navigation - ↑↓ arrow keys now work properly to scroll through commands
• Fixed Tab completion for command selection
• Improved keyboard handling using screen-level events instead of input-level

🎨 UI Improvements

• New animated robot mascot that blinks and changes expressions
• Cleaner, more compact header design
• Better navigation hints in quick actions bar
• Mascot animation cleanup on exit

---

v1.4.0 Release - UX Overhaul & Vibe Coding

🎨 Major UX Improvements

Redesigned TUI

• Modern, cleaner ASCII logo
• Quick actions bar with keyboard shortcuts
• Real-time context line showing project, git, mode, model, and current task
• Smart suggestions that adapt to your current state
• Animated spinner with contextual messages during processing
• File autocomplete for /open, /read, /cat, /close commands
• Command history navigation with up/down arrows
• Placeholder text that changes based on mode and state

Keyboard Shortcuts

• Ctrl+D - Quick /do (plan + generate)
• Ctrl+R - Quick /run (full auto)
• Ctrl+P - Quick /plan
• Ctrl+G - Quick /generate
• Ctrl+Z - Quick /undo
• Ctrl+A - Quick /ask
• Ctrl+F - Quick /fix
• Ctrl+C - Exit

New Commands

• /yolo - Activate auto mode with style
• /whatnow - Contextual suggestions based on current state
• /examples - Show example tasks to get started
• /edit - Quick switch to edit mode
• /debug - Quick switch to debug mode
• /review - Quick switch to review mode
• /explain - Quick switch to explain mode

Enhanced Help System

• /help modes - Detailed mode descriptions with icons
• /help workflow - Step-by-step workflow guide
• /help shortcuts - All keyboard shortcuts and aliases
• /help quick - Quick command reference
• Categorized command listing

50+ Command Aliases

• Single letter: /h, /p, /g, /d, /a, /u, /s, /c, /f, /m, /r, /x, /o, /t, /v
• Word aliases: /gen, /show, /view, /cat, /ls, /list, /add, /rm, /find, /grep, /auto, /quick, /execute, /rollback, /revert, /info, /state, /check, /health, /cfg, /config, /prefs

Improved Status Display

• Mode with icons (⚡ auto, ✏️ edit, ❓ ask, 🔧 debug, 👁 review, 📖 explain)
• State indicators (ready, pending, planned, intent)
• Contextual next-step suggestions
• Git status with uncommitted file count

Better Visual Feedback

• Color-coded mode indicators
• Progress spinners with context-aware messages
• Enhanced diff display with syntax highlighting
• File operation icons (+, ~, -)
• Progress bars for long operations

UI Helpers

• progressBar() - Visual progress indicator
• spinner() - Animated spinner frames
• fileOp() - Formatted file operations
• diffLine() - Syntax-highlighted diff lines
• table() - Formatted table output
• highlight() - Emphasized text
• code() - Code/command formatting

---

🚀 Previous Features (v1.3.0)

Commands

• /do <task> - Quick execute: plan + generate
• /run <task> - Full auto: plan + generate + apply
• /retry - Retry last failed operation
• /clear - Clear current task
• /fix <desc> - Quick debug mode task
• /commit [msg] - AI-powered commit messages
• /search, /read, /cat, /tree, /ls, /touch, /mkdir
• /save, /load, /status, /version

Git Integration

• /git status/log/diff/stash/pop
• Auto-generated commit messages

Enhanced Modes

• Auto mode with workspace context
• Better mode prompts for complete code generation

---

🐛 Bug Fixes

All bug fixes from v1.3.0 included plus:

• Fixed blessed label type errors
• Fixed duplicate command handler names
• Improved error handling in TUI

---

📦 Install

npm install -g @staticpayload/zai-code@1.4.0
zcode auth
zcode

---

Quick Start

# Launch interactive TUI
zcode

# Type naturally
> add authentication to the API

# Or use quick commands
> /do add input validation
> /run fix the login bug
> /ask how does this work?

# Keyboard shortcuts
Ctrl+D  → /do
Ctrl+R  → /run
Ctrl+P  → /plan
Ctrl+G  → /generate

# Get help
> /help
> /whatnow
> /examples

---

Full Changelog

• v1.4.0 — UX overhaul: keyboard shortcuts, smart suggestions, file autocomplete, 50+ aliases
• v1.3.0 — Major feature update: 50+ new commands, bug fixes, improved UX
• v1.2.15 — Fix: Properly parse JSON responses from markdown code blocks
• v1.2.14 — Feat: Auto mode, retry logic, better TUI input handling

v1.4.3 - Safety & UX Fixes

v1.4.3 Release - Safety & UX Fixes

🛡️ Safety Improvements

Auto Mode Protection

• Added task validation - vague inputs like "hi" are now treated as questions, not file operations
• Added file path filtering - blocks creating files in src/ unless explicitly mentioned in task
• Blocks file operations outside project directory
• Better prompts to prevent model from creating random files

Casual Chat Detection

• Improved greeting detection (hi, hii, hiii, hey, heyyy, yo, etc.)
• Short inputs (≤4 chars) are now properly routed to chat handler
• Auto mode no longer executes file operations for casual chat

🎨 UI Improvements

Big ASCII Logo

• New large "ZAI CODE" ASCII art banner
• Toggle on/off in settings (ASCII Logo setting)

Settings Menu Fixed

• Completely rewritten settings modal with proper keyboard handling
• Added Default Mode setting - choose startup mode (edit/auto/ask/debug/review/explain)
• Added ASCII Logo toggle
• Up/Down/Enter/Escape all work properly now
• Mouse support for clicking options

Command Palette Fixed

• Up/Down arrow navigation now works correctly
• Proper filtering of commands as you type
• Tab completion works with selected item

⚙️ New Settings

• Default Mode - Set which mode zcode starts in (edit, auto, ask, debug, review, explain)
• ASCII Logo - Toggle the big ASCII banner on/off

---

v1.4.2 Release - Core Functionality Fixes

🐛 Critical Bug Fixes

Mode Routing Fixed

• Fixed "hi" and casual chat triggering wrong workflow - now properly routes to chat handler
• Added isCasualChat() detection for greetings, small talk, thanks, etc.
• Added isSimpleQuestion() for short questions that don't need code context
• New 'chat' workflow type for natural conversation

File Creation Fixed

• Fixed auto mode not properly parsing file operations from model responses
• Improved parseFileOperations() to handle various response formats
• Better JSON extraction from markdown code blocks
• Normalized file paths (removes leading ./)

Output Scrolling Fixed

• Added mouse: true, keys: true, vi: true to output log widget
• Chat history is now scrollable with mouse wheel and keyboard

Mode Cycling Added

• Shift+Tab now cycles through modes: edit → auto → ask → debug → review → explain
• Visual feedback when mode changes

Improved Auto Mode

• Better system prompt for file operations with explicit JSON format
• Fallback handling when model doesn't return structured response
• Shows raw output when no file operations detected

---

v1.4.1 Release - UX Fixes

🐛 Bug Fixes

• Fixed command palette navigation - ↑↓ arrow keys now work properly to scroll through commands
• Fixed Tab completion for command selection
• Improved keyboard handling using screen-level events instead of input-level

🎨 UI Improvements

• New animated robot mascot that blinks and changes expressions
• Cleaner, more compact header design
• Better navigation hints in quick actions bar
• Mascot animation cleanup on exit

---

v1.4.0 Release - UX Overhaul & Vibe Coding

🎨 Major UX Improvements

Redesigned TUI

• Modern, cleaner ASCII logo
• Quick actions bar with keyboard shortcuts
• Real-time context line showing project, git, mode, model, and current task
• Smart suggestions that adapt to your current state
• Animated spinner with contextual messages during processing
• File autocomplete for /open, /read, /cat, /close commands
• Command history navigation with up/down arrows
• Placeholder text that changes based on mode and state

Keyboard Shortcuts

• Ctrl+D - Quick /do (plan + generate)
• Ctrl+R - Quick /run (full auto)
• Ctrl+P - Quick /plan
• Ctrl+G - Quick /generate
• Ctrl+Z - Quick /undo
• Ctrl+A - Quick /ask
• Ctrl+F - Quick /fix
• Ctrl+C - Exit

New Commands

• /yolo - Activate auto mode with style
• /whatnow - Contextual suggestions based on current state
• /examples - Show example tasks to get started
• /edit - Quick switch to edit mode
• /debug - Quick switch to debug mode
• /review - Quick switch to review mode
• /explain - Quick switch to explain mode

Enhanced Help System

• /help modes - Detailed mode descriptions with icons
• /help workflow - Step-by-step workflow guide
• /help shortcuts - All keyboard shortcuts and aliases
• /help quick - Quick command reference
• Categorized command listing

50+ Command Aliases

• Single letter: /h, /p, /g, /d, /a, /u, /s, /c, /f, /m, /r, /x, /o, /t, /v
• Word aliases: /gen, /show, /view, /cat, /ls, /list, /add, /rm, /find, /grep, /auto, /quick, /execute, /rollback, /revert, /info, /state, /check, /health, /cfg, /config, /prefs

Improved Status Display

• Mode with icons (⚡ auto, ✏️ edit, ❓ ask, 🔧 debug, 👁 review, 📖 explain)
• State indicators (ready, pending, planned, intent)
• Contextual next-step suggestions
• Git status with uncommitted file count

Better Visual Feedback

• Color-coded mode indicators
• Progress spinners with context-aware messages
• Enhanced diff display with syntax highlighting
• File operation icons (+, ~, -)
• Progress bars for long operations

UI Helpers

• progressBar() - Visual progress indicator
• spinner() - Animated spinner frames
• fileOp() - Formatted file operations
• diffLine() - Syntax-highlighted diff lines
• table() - Formatted table output
• highlight() - Emphasized text
• code() - Code/command formatting

---

🚀 Previous Features (v1.3.0)

Commands

• /do <task> - Quick execute: plan + generate
• /run <task> - Full auto: plan + generate + apply
• /retry - Retry last failed operation
• /clear - Clear current task
• /fix <desc> - Quick debug mode task
• /commit [msg] - AI-powered commit messages
• /search, /read, /cat, /tree, /ls, /touch, /mkdir
• /save, /load, /status, /version

Git Integration

• /git status/log/diff/stash/pop
• Auto-generated commit messages

Enhanced Modes

• Auto mode with workspace context
• Better mode prompts for complete code generation

---

🐛 Bug Fixes

All bug fixes from v1.3.0 included plus:

• Fixed blessed label type errors
• Fixed duplicate command handler names
• Improved error handling in TUI

---

📦 Install

npm install -g @staticpayload/zai-code@1.4.0
zcode auth
zcode

---

Quick Start

# Launch interactive TUI
zcode

# Type naturally
> add authentication to the API

# Or use quick commands
> /do add input validation
> /run fix the login bug
> /ask how does this work?

# Keyboard shortcuts
Ctrl+D  → /do
Ctrl+R  → /run
Ctrl+P  → /plan
Ctrl+G  → /generate

# Get help
> /help
> /whatnow
> /examples

---

Full Changelog

• v1.4.0 — UX overhaul: keyboard shortcuts, smart suggestions, file autocomplete, 50+ aliases
• v1.3.0 — Major feature update: 50+ new commands, bug fixes, improved UX
• v1.2.15 — Fix: Properly parse JSON responses from markdown code blocks
• v1.2.14 — Feat: Auto mode, retry logic, better TUI input handling

v1.4.2 - Core Functionality Fixes

v1.4.2 Release - Core Functionality Fixes

🐛 Critical Bug Fixes

Mode Routing Fixed

• Fixed "hi" and casual chat triggering wrong workflow - now properly routes to chat handler
• Added isCasualChat() detection for greetings, small talk, thanks, etc.
• Added isSimpleQuestion() for short questions that don't need code context
• New 'chat' workflow type for natural conversation

File Creation Fixed

• Fixed auto mode not properly parsing file operations from model responses
• Improved parseFileOperations() to handle various response formats
• Better JSON extraction from markdown code blocks
• Normalized file paths (removes leading ./)

Output Scrolling Fixed

• Added mouse: true, keys: true, vi: true to output log widget
• Chat history is now scrollable with mouse wheel and keyboard

Mode Cycling Added

• Shift+Tab now cycles through modes: edit → auto → ask → debug → review → explain
• Visual feedback when mode changes

Improved Auto Mode

• Better system prompt for file operations with explicit JSON format
• Fallback handling when model doesn't return structured response
• Shows raw output when no file operations detected

---

v1.4.1 Release - UX Fixes

🐛 Bug Fixes

• Fixed command palette navigation - ↑↓ arrow keys now work properly to scroll through commands
• Fixed Tab completion for command selection
• Improved keyboard handling using screen-level events instead of input-level

🎨 UI Improvements

• New animated robot mascot that blinks and changes expressions
• Cleaner, more compact header design
• Better navigation hints in quick actions bar
• Mascot animation cleanup on exit

---

v1.4.0 Release - UX Overhaul & Vibe Coding

🎨 Major UX Improvements

Redesigned TUI

• Modern, cleaner ASCII logo
• Quick actions bar with keyboard shortcuts
• Real-time context line showing project, git, mode, model, and current task
• Smart suggestions that adapt to your current state
• Animated spinner with contextual messages during processing
• File autocomplete for /open, /read, /cat, /close commands
• Command history navigation with up/down arrows
• Placeholder text that changes based on mode and state

Keyboard Shortcuts

• Ctrl+D - Quick /do (plan + generate)
• Ctrl+R - Quick /run (full auto)
• Ctrl+P - Quick /plan
• Ctrl+G - Quick /generate
• Ctrl+Z - Quick /undo
• Ctrl+A - Quick /ask
• Ctrl+F - Quick /fix
• Ctrl+C - Exit

New Commands

• /yolo - Activate auto mode with style
• /whatnow - Contextual suggestions based on current state
• /examples - Show example tasks to get started
• /edit - Quick switch to edit mode
• /debug - Quick switch to debug mode
• /review - Quick switch to review mode
• /explain - Quick switch to explain mode

Enhanced Help System

• /help modes - Detailed mode descriptions with icons
• /help workflow - Step-by-step workflow guide
• /help shortcuts - All keyboard shortcuts and aliases
• /help quick - Quick command reference
• Categorized command listing

50+ Command Aliases

• Single letter: /h, /p, /g, /d, /a, /u, /s, /c, /f, /m, /r, /x, /o, /t, /v
• Word aliases: /gen, /show, /view, /cat, /ls, /list, /add, /rm, /find, /grep, /auto, /quick, /execute, /rollback, /revert, /info, /state, /check, /health, /cfg, /config, /prefs

Improved Status Display

• Mode with icons (⚡ auto, ✏️ edit, ❓ ask, 🔧 debug, 👁 review, 📖 explain)
• State indicators (ready, pending, planned, intent)
• Contextual next-step suggestions
• Git status with uncommitted file count

Better Visual Feedback

• Color-coded mode indicators
• Progress spinners with context-aware messages
• Enhanced diff display with syntax highlighting
• File operation icons (+, ~, -)
• Progress bars for long operations

UI Helpers

• progressBar() - Visual progress indicator
• spinner() - Animated spinner frames
• fileOp() - Formatted file operations
• diffLine() - Syntax-highlighted diff lines
• table() - Formatted table output
• highlight() - Emphasized text
• code() - Code/command formatting

---

🚀 Previous Features (v1.3.0)

Commands

• /do <task> - Quick execute: plan + generate
• /run <task> - Full auto: plan + generate + apply
• /retry - Retry last failed operation
• /clear - Clear current task
• /fix <desc> - Quick debug mode task
• /commit [msg] - AI-powered commit messages
• /search, /read, /cat, /tree, /ls, /touch, /mkdir
• /save, /load, /status, /version

Git Integration

• /git status/log/diff/stash/pop
• Auto-generated commit messages

Enhanced Modes

• Auto mode with workspace context
• Better mode prompts for complete code generation

---

🐛 Bug Fixes

All bug fixes from v1.3.0 included plus:

• Fixed blessed label type errors
• Fixed duplicate command handler names
• Improved error handling in TUI

---

📦 Install

npm install -g @staticpayload/zai-code@1.4.0
zcode auth
zcode

---

Quick Start

# Launch interactive TUI
zcode

# Type naturally
> add authentication to the API

# Or use quick commands
> /do add input validation
> /run fix the login bug
> /ask how does this work?

# Keyboard shortcuts
Ctrl+D  → /do
Ctrl+R  → /run
Ctrl+P  → /plan
Ctrl+G  → /generate

# Get help
> /help
> /whatnow
> /examples

---

Full Changelog

• v1.4.0 — UX overhaul: keyboard shortcuts, smart suggestions, file autocomplete, 50+ aliases
• v1.3.0 — Major feature update: 50+ new commands, bug fixes, improved UX
• v1.2.15 — Fix: Properly parse JSON responses from markdown code blocks
• v1.2.14 — Feat: Auto mode, retry logic, better TUI input handling

v1.4.1 - UX Fixes & Animated Mascot

v1.4.1 Release - UX Fixes

🐛 Bug Fixes

• Fixed command palette navigation - ↑↓ arrow keys now work properly to scroll through commands
• Fixed Tab completion for command selection
• Improved keyboard handling using screen-level events instead of input-level

🎨 UI Improvements

• New animated robot mascot that blinks and changes expressions
• Cleaner, more compact header design
• Better navigation hints in quick actions bar
• Mascot animation cleanup on exit

---

v1.4.0 Release - UX Overhaul & Vibe Coding

🎨 Major UX Improvements

Redesigned TUI

• Modern, cleaner ASCII logo
• Quick actions bar with keyboard shortcuts
• Real-time context line showing project, git, mode, model, and current task
• Smart suggestions that adapt to your current state
• Animated spinner with contextual messages during processing
• File autocomplete for /open, /read, /cat, /close commands
• Command history navigation with up/down arrows
• Placeholder text that changes based on mode and state

Keyboard Shortcuts

• Ctrl+D - Quick /do (plan + generate)
• Ctrl+R - Quick /run (full auto)
• Ctrl+P - Quick /plan
• Ctrl+G - Quick /generate
• Ctrl+Z - Quick /undo
• Ctrl+A - Quick /ask
• Ctrl+F - Quick /fix
• Ctrl+C - Exit

New Commands

• /yolo - Activate auto mode with style
• /whatnow - Contextual suggestions based on current state
• /examples - Show example tasks to get started
• /edit - Quick switch to edit mode
• /debug - Quick switch to debug mode
• /review - Quick switch to review mode
• /explain - Quick switch to explain mode

Enhanced Help System

• /help modes - Detailed mode descriptions with icons
• /help workflow - Step-by-step workflow guide
• /help shortcuts - All keyboard shortcuts and aliases
• /help quick - Quick command reference
• Categorized command listing

50+ Command Aliases

• Single letter: /h, /p, /g, /d, /a, /u, /s, /c, /f, /m, /r, /x, /o, /t, /v
• Word aliases: /gen, /show, /view, /cat, /ls, /list, /add, /rm, /find, /grep, /auto, /quick, /execute, /rollback, /revert, /info, /state, /check, /health, /cfg, /config, /prefs

Improved Status Display

• Mode with icons (⚡ auto, ✏️ edit, ❓ ask, 🔧 debug, 👁 review, 📖 explain)
• State indicators (ready, pending, planned, intent)
• Contextual next-step suggestions
• Git status with uncommitted file count

Better Visual Feedback

• Color-coded mode indicators
• Progress spinners with context-aware messages
• Enhanced diff display with syntax highlighting
• File operation icons (+, ~, -)
• Progress bars for long operations

UI Helpers

• progressBar() - Visual progress indicator
• spinner() - Animated spinner frames
• fileOp() - Formatted file operations
• diffLine() - Syntax-highlighted diff lines
• table() - Formatted table output
• highlight() - Emphasized text
• code() - Code/command formatting

---

🚀 Previous Features (v1.3.0)

Commands

• /do <task> - Quick execute: plan + generate
• /run <task> - Full auto: plan + generate + apply
• /retry - Retry last failed operation
• /clear - Clear current task
• /fix <desc> - Quick debug mode task
• /commit [msg] - AI-powered commit messages
• /search, /read, /cat, /tree, /ls, /touch, /mkdir
• /save, /load, /status, /version

Git Integration

• /git status/log/diff/stash/pop
• Auto-generated commit messages

Enhanced Modes

• Auto mode with workspace context
• Better mode prompts for complete code generation

---

🐛 Bug Fixes

All bug fixes from v1.3.0 included plus:

• Fixed blessed label type errors
• Fixed duplicate command handler names
• Improved error handling in TUI

---

📦 Install

npm install -g @staticpayload/zai-code@1.4.0
zcode auth
zcode

---

Quick Start

# Launch interactive TUI
zcode

# Type naturally
> add authentication to the API

# Or use quick commands
> /do add input validation
> /run fix the login bug
> /ask how does this work?

# Keyboard shortcuts
Ctrl+D  → /do
Ctrl+R  → /run
Ctrl+P  → /plan
Ctrl+G  → /generate

# Get help
> /help
> /whatnow
> /examples

---

Full Changelog

• v1.4.0 — UX overhaul: keyboard shortcuts, smart suggestions, file autocomplete, 50+ aliases
• v1.3.0 — Major feature update: 50+ new commands, bug fixes, improved UX
• v1.2.15 — Fix: Properly parse JSON responses from markdown code blocks
• v1.2.14 — Feat: Auto mode, retry logic, better TUI input handling

v1.4.0 - UX Overhaul & Vibe Coding

v1.4.0 Release - UX Overhaul & Vibe Coding

🎨 Major UX Improvements

Redesigned TUI

• Modern, cleaner ASCII logo
• Quick actions bar with keyboard shortcuts
• Real-time context line showing project, git, mode, model, and current task
• Smart suggestions that adapt to your current state
• Animated spinner with contextual messages during processing
• File autocomplete for /open, /read, /cat, /close commands
• Command history navigation with up/down arrows
• Placeholder text that changes based on mode and state

Keyboard Shortcuts

• Ctrl+D - Quick /do (plan + generate)
• Ctrl+R - Quick /run (full auto)
• Ctrl+P - Quick /plan
• Ctrl+G - Quick /generate
• Ctrl+Z - Quick /undo
• Ctrl+A - Quick /ask
• Ctrl+F - Quick /fix
• Ctrl+C - Exit

New Commands

• /yolo - Activate auto mode with style
• /whatnow - Contextual suggestions based on current state
• /examples - Show example tasks to get started
• /edit - Quick switch to edit mode
• /debug - Quick switch to debug mode
• /review - Quick switch to review mode
• /explain - Quick switch to explain mode

Enhanced Help System

• /help modes - Detailed mode descriptions with icons
• /help workflow - Step-by-step workflow guide
• /help shortcuts - All keyboard shortcuts and aliases
• /help quick - Quick command reference
• Categorized command listing

50+ Command Aliases

• Single letter: /h, /p, /g, /d, /a, /u, /s, /c, /f, /m, /r, /x, /o, /t, /v
• Word aliases: /gen, /show, /view, /cat, /ls, /list, /add, /rm, /find, /grep, /auto, /quick, /execute, /rollback, /revert, /info, /state, /check, /health, /cfg, /config, /prefs

Improved Status Display

• Mode with icons (⚡ auto, ✏️ edit, ❓ ask, 🔧 debug, 👁 review, 📖 explain)
• State indicators (ready, pending, planned, intent)
• Contextual next-step suggestions
• Git status with uncommitted file count

Better Visual Feedback

• Color-coded mode indicators
• Progress spinners with context-aware messages
• Enhanced diff display with syntax highlighting
• File operation icons (+, ~, -)
• Progress bars for long operations

UI Helpers

• progressBar() - Visual progress indicator
• spinner() - Animated spinner frames
• fileOp() - Formatted file operations
• diffLine() - Syntax-highlighted diff lines
• table() - Formatted table output
• highlight() - Emphasized text
• code() - Code/command formatting

---

🚀 Previous Features (v1.3.0)

Commands

• /do <task> - Quick execute: plan + generate
• /run <task> - Full auto: plan + generate + apply
• /retry - Retry last failed operation
• /clear - Clear current task
• /fix <desc> - Quick debug mode task
• /commit [msg] - AI-powered commit messages
• /search, /read, /cat, /tree, /ls, /touch, /mkdir
• /save, /load, /status, /version

Git Integration

• /git status/log/diff/stash/pop
• Auto-generated commit messages

Enhanced Modes

• Auto mode with workspace context
• Better mode prompts for complete code generation

---

🐛 Bug Fixes

All bug fixes from v1.3.0 included plus:

• Fixed blessed label type errors
• Fixed duplicate command handler names
• Improved error handling in TUI

---

📦 Install

npm install -g @staticpayload/zai-code@1.4.0
zcode auth
zcode

---

Quick Start

# Launch interactive TUI
zcode

# Type naturally
> add authentication to the API

# Or use quick commands
> /do add input validation
> /run fix the login bug
> /ask how does this work?

# Keyboard shortcuts
Ctrl+D  → /do
Ctrl+R  → /run
Ctrl+P  → /plan
Ctrl+G  → /generate

# Get help
> /help
> /whatnow
> /examples

---

Full Changelog

• v1.4.0 — UX overhaul: keyboard shortcuts, smart suggestions, file autocomplete, 50+ aliases
• v1.3.0 — Major feature update: 50+ new commands, bug fixes, improved UX
• v1.2.15 — Fix: Properly parse JSON responses from markdown code blocks
• v1.2.14 — Feat: Auto mode, retry logic, better TUI input handling

v1.2.15 - Auth Overhaul & Auto Mode

v1.2.15 Release

🎉 What's New

Authentication Overhaul

• Removed keytar dependency — No more macOS Keychain issues
• Z_KEY environment variable — Simple, portable authentication
• Auto shell profile setup — Adds export Z_KEY to .zshrc/.bashrc
• Cross-platform support — Works on macOS, Linux, Windows

Z.ai Coding Plan API

• Correct endpoint — api.z.ai/api/coding/paas/v4/
• Bearer token auth — Standard OpenAI-compatible format
• GLM models — GLM-4.7, GLM-4.6, GLM-4.5

Auto Mode

• YOLO mode — Execute tasks directly without manual steps
• Direct file operations — Creates/modifies files automatically
• Use /mode auto to enable

TUI Improvements

• Fixed input box — Proper key handling with keys: true
• Removed placeholder overlap — Clean input area
• Better console capture — log, error, warn properly redirected
• Settings modal fix — Keyboard navigation works correctly
• TTY check — Graceful handling of non-interactive terminals

Runtime Enhancements

• Request retries — Automatic retry on 5xx errors and rate limits
• 60s timeout — Configurable request timeout
• Better error messages — Network and timeout errors clearly explained

Response Parsing

• Markdown code block stripping — No more raw JSON in output
• Smart field extraction — Finds explanation/output/message fields
• Clean text display — Human-readable responses

---

📊 Stats

• 7 versions since v1.2.8
• ~2,000 lines added
• ~39,000 lines removed (keytar and native dependencies)
• Lighter package — No native compilation required

---

📦 Install

npm install -g @staticpayload/zai-code@1.2.15
zcode auth
zcode

---

Full Changelog

• v1.2.15 — Fix: Properly parse JSON responses from markdown code blocks
• v1.2.14 — Feat: Auto mode, retry logic, better TUI input handling
• v1.2.13 — Fix: Add keys:true to textbox for proper input
• v1.2.12 — Fix: Use Z.ai Coding Plan endpoint
• v1.2.11 — Feat: Switch to OpenAI-compatible format
• v1.2.10 — Feat: Auto-add Z_KEY to shell profile
• v1.2.9 — Feat: Replace keytar with Z_KEY env var

v1.0.1 - Initial Public Release

Z.ai Code v1.0.1

🎉 Initial public release of Z.ai Code - a Z.ai-native AI code editor.

Features

• Interactive editor shell (CLI-first, not a chatbot)
• Plan → Diff → Apply workflow (no auto-execution)
• Keyboard-driven settings menu (BIOS-style)
• Model switching (Z.ai models)
• Execution profiles (safe / balanced / fast)
• Git awareness (branch, dirty state, warnings)
• Dry-run mode
• Undo/rollback
• Task history & audit log
• Safe file operations

Installation

npm install -g @staticpayload/zai-code

Or run with npx:

npx @staticpayload/zai-code

---

⚠️ This project is NOT affiliated with Z.ai or Anthropic.