Bash mode

Overview

Bash Mode lets you run shell commands directly from the Friday input area without involving the AI. Commands execute immediately in the thread's working directory and their output is added to the conversation context so the AI can reference it.

Quick Start

Press ! in an empty input field to enter Bash Mode, then type a command and press Enter to run it.

! git status

! ls -la

Press Backspace on an empty input to exit Bash Mode without running a command.

Usage

Entering and exiting

Type ! when the input field is empty. A $ bash mode indicator appears to confirm the mode is active. The ! character itself is not part of the command.

To cancel without running a command, press Backspace on an empty input to return to normal input.

Running a command

Type any shell command and press Enter. The command runs in the thread's base directory with a 120-second timeout. Output is captured and added to the conversation context.

Output handling

Standard output and standard error are both captured and displayed. If output exceeds 100,000 characters, it is truncated to the first 2,000 characters with a note indicating the total length. If the command produces no output, (no output) is shown.

Examples

Check the current git status:

! git status

Run tests:

! pytest tests/

List files in the working directory:

! ls -la

Inspect a file:

! cat src/main.py

Search for a pattern:

! rg "TODO" --type py