XFiles Pro · iPhone · iPad · Android
Claude Code and Codex on your phone. Nothing in between.
XFiles opens the Claude Code and Codex CLIs running in Herdr on your own server as mobile apps. Follow every session line for line, reply, answer its prompts and switch models, all on the same CLI you use at your desk.
How it works
The real CLI, not a copy of it
XFiles connects to your server over SSH, the way a laptop would. Claude Code or Codex runs there inside Herdr, a terminal workspace for coding agents that knows which agent is working, waiting or done.
~/.claude and ~/.codexXFiles reads the session log the CLI already writes and the lines on its terminal, and types your messages into the CLI through Herdr. Your words reach Claude Code or Codex exactly as you typed them.
What XFiles never does
- Run
claude -p, a headless mode or a wrapper around the CLI - Send your code or prompts through a server of its own
- Add a system prompt, instructions or any text around your message
- Install hooks, MCP servers or settings that put anything into the conversation
Why that matters
A model's output is uncertain enough already. Every layer between you and the CLI makes it less predictable. With XFiles, a session behaves the same on the phone as at your desk.
When a feature would have to change a file on your server, XFiles asks first and names the file, the command and how to undo it.
Everything the terminal shows
Carry on from wherever you are
Every line, nothing cut
Replies in full Markdown, Claude's thinking, Codex's reasoning, each tool's whole command and output, edit diffs and plans. Runs of tool calls fold behind a tap, and nothing is ever cut short.
Live while it works
The working line, with its spinner, time and tokens, comes off the terminal as it changes. A session that is waiting for you is marked in the list.
Answer and steer
Reply, answer Claude Code's own prompts with the keys it shows, stop a turn, and type slash commands such as /new, /status or /diff and see what they print.
Switch mid-session
Change the model, effort, permission mode or Plan mode inside a running session, the way the CLI does at your desk.
Photos and files
Attach a photo or a file from your phone. XFiles uploads it to the server and hands the CLI its path as @/path, as if you had dropped it into the terminal.
Search and history
Search every session by what was said. Long sessions open at the latest turn and load earlier ones as you scroll. Continue any earlier session, or start a new one.
Setup as forms
Skills, subagents, commands, memory and rules open as forms. Models, plugins, and Codex's approvals and sandbox change with a tap.
One session everywhere
Phone and desk share Herdr's default session. Open the full Herdr terminal at the agent's pane whenever you want it. Tabs XFiles opened close by themselves once the agent has sat idle.
Set up in a few minutes
From your server to your phone
Have Claude Code or Codex working on a server you can reach over SSH. A Linux machine (x86_64 or arm64) or a Mac with Remote Login turned on. Sign in to the CLI there as you normally would.
Install Herdr on that server. The script installs into
~/.local/binwithout administrator rights:curl -fsSL https://herdr.dev/install.sh | shOr
brew install herdr. See herdr.dev for other options.Add the server to XFiles as an SFTP location with your SSH login. When XFiles finds
~/.claudeor~/.codex, it offers to open them as apps with Herdr. Tap Use Herdr.Tap Claude Code or Codex under the server. Open a session to follow it, or start a new one.
Start your desk sessions inside Herdr too (run herdr, then claude or codex in it), and the phone can follow and answer those as well. More on Herdr, tmux and Zellij: Keep terminal sessions running.
Questions
Do I need an Anthropic or OpenAI API key?
No. XFiles never talks to Anthropic or OpenAI. The CLI on your server uses whatever sign-in it already has, whether that is a Claude or ChatGPT plan or an API key.
Does my code pass through XFiles?
No. The phone connects straight to your server over SSH. There is no XFiles server and no account, and nothing is sent to the developer. Connection details stay on the phone.
Can I use tmux or Zellij instead of Herdr?
The Claude Code and Codex apps need Herdr: it tells XFiles which agent is working, waiting or done, and takes your messages to the right pane. With tmux or Zellij you still get the SSH terminal, which keeps Claude Code running while the phone sleeps, and any session log (.jsonl) still opens as a readable conversation in the file viewer.
Can I reach my server away from home?
Yes, from any address your phone can reach over SSH: your home network, a VPN such as Tailscale or WireGuard, or a public address. A location can keep a home address and an outside address and use whichever fits.
What does it cost?
XFiles is free to download. On iPhone and iPad, the Claude Code and Codex apps are part of XFiles Pro, an in-app purchase; the App Store page shows the plans in your country. On Android, XFiles Pro is free on Google Play.
Which devices and servers work?
iPhone and iPad with iOS 17 or later, and Android phones and tablets. The server can run Linux (x86_64 or arm64) or macOS.
Is this an official Claude Code or Codex app?
No. XFiles is an independent app by Local1st. It works with the CLIs as they are, the way you use them in a terminal, and is not affiliated with or endorsed by Anthropic or OpenAI.
Does it work on iPhone Duo?
Yes. Unfolded, iPhone Duo gives a session the room of an iPad. XFiles on iPhone Duo.
Try it with your own server
XFiles is also a full dual-pane file manager with SFTP, SMB, WebDAV, S3 and an SSH terminal. See everything it does.