Back to skills
SkillHub ClubShip Full StackFull StackTesting

freeact-interaction

Interact with freeact agent via tmux for testing

Packaged view

This page reorganizes the original catalog entry around fit, installability, and workflow context first. The original raw source lives below.

Stars
128
Hot score
95
Updated
March 20, 2026
Overall rating
C2.8
Composite score
2.8
Best-practice grade
B81.2

Install command

npx @skill-hub/cli install gradion-ai-freeact-freeact-interaction

Repository

gradion-ai/freeact

Skill path: .agents/skills/freeact-interaction

Interact with freeact agent via tmux for testing

Open repository

Best for

Primary workflow: Ship Full Stack.

Technical facets: Full Stack, Testing.

Target audience: everyone.

License: Unknown.

Original source

Catalog source: SkillHub Club.

Repository owner: gradion-ai.

This is still a mirrored public skill entry. Review the repository before installing into production workflows.

What it helps with

  • Install freeact-interaction into Claude Code, Codex CLI, Gemini CLI, or OpenCode workflows
  • Review https://github.com/gradion-ai/freeact before adding freeact-interaction to shared team environments
  • Use freeact-interaction for development workflows

Works across

Claude CodeCodex CLIGemini CLIOpenCode

Favorites: 0.

Sub-skills: 0.

Aggregator: No.

Original source / Raw SKILL.md

---
name: freeact-interaction
description: Interact with freeact agent via tmux for testing
---

# Interacting with Freeact via tmux

Freeact's terminal interface uses prompt_toolkit which requires a real TTY. Use tmux to provide a pseudo-TTY.

## Setup

```bash
# Start detached tmux session (120x50 recommended for proper rendering)
tmux new-session -d -s agent -x 120 -y 50

# Start freeact
tmux send-keys -t agent 'uv run freeact' Enter
```

## Interaction Loop

```bash
# Wait for startup/response (adjust sleep as needed)
sleep 3

# Capture current screen (-S -N for N lines of scrollback)
tmux capture-pane -t agent -p -S -50

# Send user input
tmux send-keys -t agent 'your message here' Enter

# Approve code execution
tmux send-keys -t agent 'Y' Enter
```

## Important Notes

- **Timing**: Wait between sends for the agent to respond before sending next input
- **Approval options**: Y (yes), n (no), a (always), s (session)
- **Quit**: Send `q` to exit freeact cleanly

## Cleanup

```bash
# Kill the tmux session when done
tmux kill-session -t agent
```

## Example Full Session

```bash
# Setup
tmux new-session -d -s agent -x 120 -y 50
tmux send-keys -t agent 'uv run freeact' Enter
sleep 3

# Send query
tmux send-keys -t agent 'What is 2 + 2?' Enter
sleep 5
tmux capture-pane -t agent -p -S -50

# Approve execution
tmux send-keys -t agent 'Y' Enter
sleep 3
tmux capture-pane -t agent -p -S -30

# Quit and cleanup
tmux send-keys -t agent 'q' Enter
sleep 2
tmux kill-session -t agent
```
freeact-interaction | SkillHub