manual-testing

Manual Testing

Run the acai REPL in a tmux session and interact with it to verify features work correctly. Inspect application logs and session files to confirm internal behavior.

Quick Reference

• Start session: tmux new-session -d -s acai-test "node source/index.ts"
• Send text: tmux send-keys -t acai-test -l "your prompt"
• Submit (Shift+Enter): tmux send-keys -t acai-test Escape "[13;2u"
• Send Shift+Tab: tmux send-keys -t acai-test Escape "[9;2u"
• Send Ctrl+N: tmux send-keys -t acai-test C-n
• Send Ctrl+O: tmux send-keys -t acai-test C-o
• Send Escape: tmux send-keys -t acai-test Escape
• Read screen: tmux capture-pane -t acai-test -p -S -100
• Kill session: tmux kill-session -t acai-test

Workflow

1. Start the App

tmux kill-session -t acai-test 2>/dev/null
tmux new-session -d -s acai-test "node source/index.ts"
sleep 2

Wait for the welcome screen to appear before interacting:

tmux capture-pane -t acai-test -p -S -50

Confirm you see the welcome message and the editor prompt.

2. Interact with the REPL

Type text into the editor:

tmux send-keys -t acai-test -l "hello, what mode are you in?"

Submit with Shift+Enter (kitty keyboard protocol):

tmux send-keys -t acai-test Escape "[13;2u"

Wait for the agent to respond, then read the output:

sleep 5
tmux capture-pane -t acai-test -p -S -100

For longer agent runs, poll until the agent finishes (the editor prompt reappears):

for i in $(seq 1 30); do
  output=$(tmux capture-pane -t acai-test -p -S -5)
  if echo "$output" | grep -q "›"; then
    break
  fi
  sleep 2
done
tmux capture-pane -t acai-test -p -S -100

3. Send Keyboard Shortcuts

Use tmux send-keys for special keys:

Action	Command
Shift+Tab	tmux send-keys -t acai-test Escape "[9;2u"
Ctrl+N (new chat)	tmux send-keys -t acai-test C-n
Ctrl+O (verbose)	tmux send-keys -t acai-test C-o
Escape (interrupt)	tmux send-keys -t acai-test Escape
Enter	tmux send-keys -t acai-test Enter
Tab	tmux send-keys -t acai-test Tab