Slash Commands

Cecli supports commands from within the chat, which all start with /.

Prompt Queue Management

The prompt queue is a first-in-first-out (FIFO) queue of prompts attached to the active agent. Queued prompts run after the current response finishes. Starting a new prompt also drains the queue after that prompt completes; use /queue run to start it explicitly.

If a response is interrupted (for example with Ctrl+C), the in-flight prompt is put back at the front of the queue. Use /queue run to resume processing.

/queue add Command

Usage: /queue add <prompt text>, or the shorthand /queue <prompt text>

Description: Adds a prompt to the queue for processing after the current response completes.

Examples:

/queue add "refactor database layer"
/queue "add unit tests for user service"

/queue insert Command

Usage: /queue insert <index> <prompt text>

Description: Inserts a prompt at a specific 1-based position in the queue. Existing items shift down, and the index is clamped to the queue bounds.

Examples:

/queue insert 1 "add tests for login"
/queue insert 3 "refactor database layer"

/queue list Command

Usage: /queue list

Description: Lists all queued prompts with their position and queue time.

/queue remove Command

Usage: /queue remove <index>, /queue remove *

Description: Removes the prompt at the given 1-based position, or clears the entire queue when * is used.

/queue run Command

Usage: /queue run

Description: Processes every queued prompt immediately, in FIFO order. This is mainly useful to resume a queue that was paused by an interruption.

Examples:

/queue run

Tip: You can easily re-send commands or messages. Use the up arrow ⬆ to scroll back or CONTROL-R to search your message history.

Non-TUI Related Notes

Multi-line Chat Messages

You can send long, multi-line messages in the chat in a few ways:

• Paste a multi-line message directly into the chat.
• Enter { alone on the first line to start a multiline message and } alone on the last line to end it.
  • Or, start with {tag (where “tag” is any sequence of letters/numbers) and end with tag}. This is useful when you need to include closing braces } in your message.
• Use Meta-ENTER to start a new line without sending the message (Esc+ENTER in some environments).
• Use /paste to paste text from the clipboard into the chat.
• Use the /editor command (or press Ctrl-X Ctrl-E if your terminal allows) to open your editor to create the next chat message. See editor configuration docs for more info.
• Use multiline-mode, which swaps the function of Meta-Enter and Enter, so that Enter inserts a newline, and Meta-Enter submits your command. To enable multiline mode:
  • Use the /multiline-mode command to toggle it during a session.
  • Use the --multiline switch.

Example with a tag:

{python
def hello():
    print("Hello}")  # Note: contains a brace
python}

Key Bindings

The interactive prompt is built with prompt-toolkit which provides emacs and vi keybindings.

Emacs

• Up Arrow : Move up one line in the current message.
• Down Arrow : Move down one line in the current message.
• Ctrl-Up : Scroll back through previously sent messages.
• Ctrl-Down : Scroll forward through previously sent messages.
• Ctrl-A : Move cursor to the start of the line.
• Ctrl-B : Move cursor back one character.
• Ctrl-D : Delete the character under the cursor.
• Ctrl-E : Move cursor to the end of the line.
• Ctrl-F : Move cursor forward one character.
• Ctrl-K : Delete from the cursor to the end of the line.
• Ctrl-L : Clear the screen.
• Ctrl-N : Move down to the next history entry.
• Ctrl-P : Move up to the previous history entry.
• Ctrl-R : Reverse search in command history.
• Ctrl-X Ctrl-E : Open the current input in an external editor
• Ctrl-Y : Paste (yank) text that was previously cut.

Vi

To use vi/vim keybindings, run cecli with the --vim switch.

• Up Arrow : Move up one line in the current message.
• Down Arrow : Move down one line in the current message.
• Ctrl-Up : Scroll back through previously sent messages.
• Ctrl-Down : Scroll forward through previously sent messages.
• Esc : Switch to command mode.
• i : Switch to insert mode.
• a : Move cursor one character to the right and switch to insert mode.
• A : Move cursor to the end of the line and switch to insert mode.
• I : Move cursor to the beginning of the line and switch to insert mode.
• h : Move cursor one character to the left.
• j : Move cursor down one line.
• k : Move cursor up one line.
• l : Move cursor one character to the right.
• w : Move cursor forward one word.
• b : Move cursor backward one word.
• 0 : Move cursor to the beginning of the line.
• $ : Move cursor to the end of the line.
• x : Delete the character under the cursor.
• dd : Delete the current line.
• u : Undo the last change.
• Ctrl-R : Redo the last undone change.