Add Laravel artisan completion #2349

seefood · 2025-10-07T10:20:00Z

Summary

Implements tab completion for Laravel's artisan command-line tool, addressing issue #2248.

Features

Dynamic Command Completion: Automatically retrieves available commands from php artisan list
Alias Support: Works with both artisan and the common art alias
Smart Activation: Only activates when an artisan file exists in the current directory
Robust Implementation: Uses command prefix to bypass user aliases, ensuring reliability
Clean Code: Passes all shellcheck and shfmt linting requirements

Implementation Details

The completion function:

Checks for the presence of an artisan file in the current directory
Dynamically fetches available commands using php artisan --raw --no-ansi list
Provides completions via bash's compgen builtin
Gracefully handles missing artisan file or PHP errors

Usage

After enabling the completion:

bash-it enable completion artisan

Users can tab-complete artisan commands:

php artisan make:<TAB>
# Shows: make:cast make:channel make:command make:controller ...

php artisan migr<TAB>
# Completes to: php artisan migrate

Testing

✅ Sourced successfully in bash-it environment
✅ Function properly defined with expected behavior
✅ Passes shellcheck with no warnings
✅ Passes shfmt formatting checks
✅ Passes all pre-commit hooks

Test Plan

To test this completion:

Navigate to a Laravel project directory
Enable the completion: bash-it enable completion artisan
Reload your shell or source bash-it
Try tab completion: php artisan make:<TAB> or artisan migr<TAB>
Verify completions appear for valid artisan commands

🤖 Generated with Claude Code

Implements tab completion for Laravel's artisan command-line tool. **Features:** - Dynamic command completion from `php artisan list` - Works with both `artisan` and `art` aliases - Only activates when artisan file exists in current directory - Uses `command` prefix to bypass user aliases for robustness - Follows bash-it completion conventions **Implementation:** - Parses `php artisan --raw --no-ansi list` output - Provides completions via bash's `compgen` builtin - Gracefully handles missing artisan file or PHP errors - Passes shellcheck and shfmt linting **Use Case:** Developers working with Laravel projects can now tab-complete artisan commands like `make:controller`, `migrate`, `tinker`, etc., improving productivity and reducing typos. Closes Bash-it#2248 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>

Updated all three planning documents to reflect the completed work: **Issues Fixed (6 total)**: - #2317: Auto-detect git remote (PR #2345) - #2248: Laravel artisan completion (PR #2349) - #2296: down4me URL malformation (PR #2350) - #2260: SSH completion @ sign (PR #2351) - #2238: Uninstall script backup (PR #2352) - #2216: Node version conditional display (PR #2353) **Changes to docs/plans/**: 1. bash-it-issues-comprehensive-analysis.md - Marked 5 quick wins as FIXED with PR numbers - Updated executive summary: 32 → 27 open issues - Updated work plan to show Phase 1 completed - Updated issue reference appendix 2. bash-it-quick-reference.md - Moved completed issues to "Fixed" section - Updated TL;DR metrics - Removed completed items from decision list - Updated metrics table with current progress 3. bash-it-roadmap-2025.md - Updated health metrics (32 → 27 issues) - Marked Phase 1 as COMPLETED - Listed all 6 PRs with dates - Updated success criteria checkmarks **Remaining Work**: - 1 quick fix (#2314 - todo alias rename) - 18 stale issues to close - 4 strategic decisions needed 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>