| name | freeact-interaction |
| description | Interact with freeact agent via tmux for testing |
Interacting with Freeact via tmux
Freeact's terminal UI (Textual) requires a real TTY. Use tmux to provide a pseudo-TTY.
Setup
tmux new-session -d -s agent -x 120 -y 50
tmux set-option -t agent remain-on-exit on
tmux send-keys -t agent 'uv run freeact' Enter
Wait at least 10 seconds for startup (MCP servers need to initialize).
Capturing Output
Textual renders to the terminal's alternate screen buffer. tmux capture-pane captures it correctly as long as stderr is not redirected.
tmux capture-pane -t agent -p
tmux capture-pane -t agent -p -S -50
Sending Input
Use separate tool calls for sending keys and capturing output. Never chain tmux send-keys and tmux capture-pane in a single bash command -- the shell command text leaks into the Textual prompt.
tmux send-keys -t agent -l 'your message here'
Then in a separate call:
tmux send-keys -t agent Enter
Then wait and capture in another separate call.
Approval Prompt
tmux send-keys -t agent 'y'
Quit and Cleanup
tmux send-keys -t agent C-q
sleep 2
tmux kill-session -t agent
Additional guides