How do I install the Freeact Interaction skill?

Run npx skillmds@latest add tomevault-io/freeact-interaction in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Freeact Interaction safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Freeact Interaction?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Freeact Interaction free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Freeact Interaction?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Freeact Interaction by tomevault-io

Name: Freeact Interaction
Author: tomevault-io

File contents

Interacting with Freeact via tmux

Freeact's terminal UI (Textual) requires a real TTY. Use tmux to provide a pseudo-TTY.

Setup

# Start detached tmux session (120x50 recommended for proper rendering)
tmux new-session -d -s agent -x 120 -y 50
tmux set-option -t agent remain-on-exit on

# Start freeact (do NOT redirect stderr, it breaks Textual's terminal detection)
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.

# Capture visible screen
tmux capture-pane -t agent -p

# Capture with scrollback
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.

# Send literal text (use -l to avoid key interpretation)
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

# Approve: y, Reject: n, Always: a, Session: s
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

Slash commands - Testing /skill-name invocation via the skill picker
Image attachments - Testing @path image attachments via the file picker

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: freeact-interactiondescription: Interact with freeact agent via tmux for testing Use when this capability is needed.---# Interacting with Freeact via tmuxFreeact's terminal UI (Textual) 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 50tmux set-option -t agent remain-on-exit on# Start freeact (do NOT redirect stderr, it breaks Textual's terminal detection)tmux send-keys -t agent 'uv run freeact' Enter```Wait at least 10 seconds for startup (MCP servers need to initialize).## Capturing OutputTextual renders to the terminal's alternate screen buffer. `tmux capture-pane` captures it correctly as long as stderr is not redirected.```bash# Capture visible screentmux capture-pane -t agent -p# Capture with scrollbacktmux capture-pane -t agent -p -S -50```## Sending InputUse 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.```bash# Send literal text (use -l to avoid key interpretation)tmux send-keys -t agent -l 'your message here'```Then in a separate call:```bashtmux send-keys -t agent Enter```Then wait and capture in another separate call.## Approval Prompt```bash# Approve: y, Reject: n, Always: a, Session: stmux send-keys -t agent 'y'```## Quit and Cleanup```bashtmux send-keys -t agent C-qsleep 2tmux kill-session -t agent```## Additional guides- [Slash commands](references/slash-commands.md) - Testing `/skill-name` invocation via the skill picker- [Image attachments](references/image-attachments.md) - Testing `@path` image attachments via the file picker---> Converted and distributed by [TomeVault](https://tomevault.io/claim/gradion-ai) — claim your Tome and manage your conversions.

Frequently asked questions

Freeact Interaction