fest shell-init

Output shell integration code for festival helpers

Synopsis

Output shell code that provides shell helper functions.

This command outputs shell-specific code that creates helper functions:

• fgo: Wraps 'fest go' to change your working directory
• fls: Wraps 'fest list' for quick festival listing

SETUP (one-time):

  # For zsh, add to ~/.zshrc:
  eval "$(fest shell-init zsh)"

  # For bash, add to ~/.bashrc:
  eval "$(fest shell-init bash)"

  # For fish, add to ~/.config/fish/config.fish:
  fest shell-init fish | source

After setup, reload your shell or run: source ~/.zshrc

USAGE - fgo (navigation): fgo Smart navigation (linked project ↔ festival, or festivals root) fgo 002 Navigate to phase 002 fgo 2/1 Navigate to phase 2, sequence 1 fgo active Navigate to active directory fgo link Link current festival to project (or vice versa) fgo --help Show fgo help

USAGE - fls (listing): fls List all festivals grouped by status fls active List active festivals only fls --json List festivals in JSON format fls --help Show fest list help

fest shell-init <shell> [flags]

Examples

  # Output zsh integration code
  fest shell-init zsh

  # Add to your shell config (zsh)
  eval "$(fest shell-init zsh)"

  # After setup, use the helpers:
  fgo              # Go to festivals root
  fgo 2            # Go to phase 002
  fls              # List all festivals
  fls active       # List active festivals

Options

  -h, --help   help for shell-init

Options inherited from parent commands

      --config string   config file (default: ~/.config/fest/config.json)
      --debug           enable debug logging
      --no-color        disable colored output
      --verbose         enable verbose output

SEE ALSO

• fest - Festival Methodology CLI - goal-oriented project management for AI agents