Working with fx

Start fx in a project and send a prompt.

Send a prompt

Fix the search box losing its value when I go back, and add a regression test.

Type @ to mention a file or folder, or /image <path> to attach an image. An image file you mention is attached too.

File suggestions rank exact names, name prefixes, and whole-word matches ahead of scattered letters. You can include a file's containing folder in the search, and the highlighted letters show the match. The picker shows up to 10 rows when the terminal has room. Press Enter to mention the selected file or folder, or Tab to open a folder and search inside it.

Steering

Send a follow-up prompt while fx works. fx treats it as steering:

  • While fx is responding, it stops the response and continues with your follow-up.
  • While a shell command is running, fx moves the command to the background and continues with your follow-up. The command keeps running, and fx can still check on it or stop it. If you then press escape twice to interrupt that turn, fx stops the commands it moved to the background during it.
  • While another tool or context compaction is running, fx applies the follow-up when it finishes.

A follow-up that includes an image or a skill ends the current turn instead, and runs as the next one. While a follow-up waits for a tool or compaction, press up in an empty composer to take it back and edit it.

Press escape twice to interrupt. File changes and commands that already ran remain in place.

Review the result

Press ctrl+o to open Full detail, which includes the conversation and complete command output. Press ctrl+o or escape to close it.

/undo reverts the latest file operation made with fx's file tools. It does not undo shell commands or changes to external services.

Input shortcuts

Press shift+enter to start a new line, or up on the first line of your draft to bring back an earlier prompt. Keyboard shortcuts lists every shortcut.

Pick up later

Run fx -c in the same workspace to resume its remembered session. See Sessions for other ways to resume.

To delegate part of a task, see Subagents. To run several conversations in one terminal, see Instances.