umputun

umputun / fya

Public

PTY-backed Claude Code wrapper that provides claude -p compatible output

ai-agents claude-code wrapper
15
0
89% credibility
Found May 26, 2026 at 15 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Go
AI Summary

fya is a wrapper tool that makes Claude Code work like a simple command-line program. Instead of opening Claude's visual interface, it runs Claude in the background inside a hidden terminal, types your question character-by-character like a human would, watches Claude's conversation logs to catch the response, and delivers the answer in the format you prefer—plain text, structured data, or a live stream of words as they're generated. This lets you use Claude Code inside scripts, automation tools, or other programs that need to talk to an AI assistant programmatically.

How It Works

1
💭 You want to automate Claude Code

You're building a script or tool that needs to talk to Claude, but Claude Code normally works like a chat app with a visual interface.

2
🔧 You find fya as your bridge

You discover fya, a tool that wraps Claude Code and makes it behave like a simple command-line program that takes a question and gives you an answer.

3
📦 You install it in one click

You install fya using Homebrew or download a ready-made file for your computer. Everything you need comes in one package.

4
✨ You type your question and get your answer

You run fya with your question, and it opens Claude Code behind the scenes, types your question like a person would, waits for the response, and gives you back exactly what Claude said.

5
You choose how you want the answer
📝
Plain text

Just the words, nothing else

📋
Structured data

A clean data format for scripts

🌊
Live stream

Watch the answer appear word by word

6
🔗 You connect it to your tools

You can use fya inside other programs that expect Claude Code, making it easy to add AI powers to your existing workflow.

🎉 Your automation comes to life

Your scripts can now ask Claude questions and get answers back, just like having a tireless assistant that never gets tired or makes mistakes.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 15 to 15 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is fya?

Fya is a Go-based wrapper that makes Claude Code behave like a simple command-line tool. Normally, Claude Code runs as an interactive terminal application, but fya spins it up inside a pseudo-terminal (PTY), types your prompt into it like a human would, then watches the transcript log files Claude writes and streams the response back to you. The result is drop-in compatibility with `claude -p` -- you get the same text, JSON, or streaming JSON output that tools expect, but through an interactive session instead of the print-mode command. It handles the messy middle parts: waiting for Claude to be ready, mimicking typing speed with configurable WPM and jitter, and cleaning up environment variables that would otherwise leak between parent and child processes.

Why is it gaining traction?

The hook is compatibility without compromise. Claude's native `-p` mode has limitations -- no interactive prompts, no multi-turn, no tool use in some configurations. Fya lets you run Claude exactly as the CLI presents it, with all its capabilities intact, but pipe the output into other tools. The integration with Ralphex is particularly interesting: swap out the Claude command in your Ralphex config and you get streaming JSONL output suitable for downstream consumers. The typing simulation is clever too -- it prevents Claude from detecting programmatic calls, which matters when you want the full interactive experience rather than a restricted print-mode subset.

Who should use this?

DevOps and platform engineers building Claude-powered pipelines who need streaming output. Researchers running automated experiments that require Claude's full tool ecosystem. Teams using Ralphex or similar proxies who want a lightweight Claude relay without hosting their own proxy server. Not for beginners -- you'll need Claude Code installed, comfortable with terminal tools, and willing to work through early-adoption rough edges.

Verdict

Fya solves a real problem for a narrow audience, and it solves it well given its 15-star maturity. The code quality is solid (extensive tests, linting, clear architecture), and the 0.8999% credibility score reflects legitimate engineering even if the star count signals early days. Try it if you need Claude streaming output without print-mode restrictions. Hold off if you want battle-tested tooling or Windows support -- v1 explicitly returns an error on Windows, and transcript parsing may drift as Claude Code evolves.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.