{"slug": "your-ai-coding-agent-is-working-in-a-folder-you-can-t-see", "title": "Your AI Coding Agent Is Working in a Folder You Can't See", "summary": "A developer has built Iruka, a native Swift file manager for macOS that integrates a terminal and file browsing to improve the experience of supervising AI coding agents. The tool addresses common frictions such as the 'cd dance', invisible file changes, and the pile of Markdown files generated by agents, by allowing users to navigate to files and see them rendered as documents, code, or grids without switching apps. The developer argues that the environment around AI agents, not the agents themselves, is outdated and needs redesign.", "body_md": "Here's a workflow that has quietly become normal in 2026: you open a terminal, type `claude`\n\n(or fire up Grok, Kimi, or whatever agent you run), and start delegating. The agent reads files, edits files, writes files. You supervise.\n\nAnd here's the part nobody talks about: the supervision experience is terrible.\n\nYour agent lives in a terminal window. Your files live in Finder, or your editor's sidebar. Your agent's *output* (plans, reports, summaries, README updates) lands on disk as Markdown that Finder renders as a wall of `#`\n\nand `*`\n\n. So you sit there alt-tabbing between a terminal, a file browser, and an editor, playing air traffic controller for a process that's supposed to be saving you time.\n\nI spent months doing exactly this before admitting the tooling was wrong. Not the agent... the agent is great. The *environment* around the agent was designed in 2001.\n\nFull disclosure before we go further: I'm the developer of the app this article ends with. But the problem is real regardless of whose tool you use to fix it, so let's start there.\n\n**Friction 1: the cd dance.** Your agent works in the terminal's current directory. Your attention works wherever you're browsing. These drift apart constantly. You're looking at `components/auth/`\n\nin your file browser while your agent session sits in the repo root, and every task starts with re-aiming it: \"look at the file in components/auth/...\". You are a human path-resolver.\n\n**Friction 2: invisible changes.** The agent says \"I've updated the config and refactored the handler.\" Did it? What does it look like now? Your options: ask the agent to cat the file (burning tokens to see your own disk), switch to your editor and navigate to it, or trust blindly. None of these are *glancing at the file*, which is what you actually want.\n\n**Friction 3: the Markdown pile.** Agents narrate in Markdown. Plans, migration guides, analysis reports, CHANGELOGs — my projects have accumulated dozens of agent-written `.md`\n\nfiles. These are *documents*, written to be read. Every mainstream file manager shows them as raw markup, because in 2001 nobody's disk was full of Markdown.\n\nNone of these frictions is huge. But you hit each of them dozens of times per session, and agentic coding is *supposed* to be about eliminating exactly this kind of overhead.\n\nWork backwards from the workflow and the requirements are obvious:\n\nThe terminal and the file browser should share a location. Browse to a folder, and the shell — and therefore your agent — is already there. Point at things by *navigating to them*, not by typing paths into a prompt.\n\nFiles should be readable the moment you select them. Markdown as a formatted document. CSV as a grid. Code with syntax highlighting. Zero clicks, zero app switches. You're reviewing an agent's work, not archaeology.\n\nSmall fixes should happen in place. The agent left a wrong value in a config? Click, fix, save. Round-tripping through the agent (\"please change line 14...\") for a two-character edit is absurd; so is opening an IDE for it.\n\nAnd the loop should end where it starts: see the git status, commit, push —> from the same window.\n\nThis is not a radical vision. It's roughly what KDE's Dolphin gave Linux users twenty years ago (minus the AI, the previews, and git). It just never existed on macOS.\n\n[Iruka](https://iruka.sh) (イルカ — \"dolphin\" in Japanese, named for its inspiration) is a native Swift file manager for macOS built around exactly this loop. The agentic workflow in practice:\n\nI browse to a project. The integrated terminal is already there — no `cd`\n\n, ever. I type `claude`\n\nand start a session. As I click around the project, the session's context and my visual context stay glued together: when I say \"fix the bug in this file,\" *this file* means the one I'm looking at.\n\nWhile the agent works, I watch files change in the preview pane next to the terminal - rendered Markdown, highlighted code, CSV grids. When it writes `MIGRATION-PLAN.md`\n\n, I read it as a document, immediately, without leaving the window.\n\nOne detail I'm particularly happy with: **follow-mode pauses itself during long-running commands.** If the agent is mid-task (or you're mid-`npm install`\n\n), navigating around won't yank the shell's directory out from under it — Iruka detects the running process, pauses the sync, and offers to resume when it's done. This is the feature that makes the synced terminal actually usable with agents rather than just a demo trick; a stray click can't corrupt a 20-minute session.\n\nWhen the agent's done: git status is right there in the browser — branch, staged files — and I commit and push without touching another app. If something's slightly off, the Edit button in the preview pane fixes it in place. If I want to verify a change landed everywhere, Power Search greps the whole tree with regex, no indexing.\n\nThe whole supervision loop (aim, delegate, watch, read, fix, commit) happens on one continuous surface.\n\nAnd it extends past your own machine. Saved SSH hosts connect from the sidebar with one click —> the terminal opens already connected, so running an agent session *on a remote server* is the same workflow, minus typing IPs from memory. Right-click any local file to SCP it over; mount S3, SFTP (even as sudo), or WebDAV and browse them like local folders.\n\nTo be clear, none of this rides on a stripped-down browser: Iruka is a full Finder replacement first — dual-pane browsing, batch rename with preview, an operations queue for big transfers, list/column/icon views, symlink support. The agent workflow is what's *new*; the file manager underneath is complete.\n\nIruka is not an IDE and doesn't try to be — for serious editing you'll still want your editor, and the in-place editing is deliberately scoped to quick fixes. It's macOS-only (14+, native Swift, no Electron), and it's paid: $19.99 one-time, no subscription, with a 30-day trial and no credit card. If your agent workflow lives entirely inside VS Code with an extension, you may not need any of this. Mine never did. I think in folders and shells, and if you've read this far, you probably do too.\n\nThe roadmap is community-driven through [GitHub Discussions](https://github.com/dorienh/iruka-releases/discussions). Several shipped features came straight from user requests, and \"make it better for agent sessions\" is currently the loudest theme.\n\nAgents got a generational upgrade in the last two years. The room they work in didn't. It's time.", "url": "https://wpnews.pro/news/your-ai-coding-agent-is-working-in-a-folder-you-can-t-see", "canonical_source": "https://dev.to/dorien/your-ai-coding-agent-is-working-in-a-folder-you-cant-see-o2d", "published_at": "2026-08-11 07:38:47+00:00", "updated_at": "2026-08-11 07:46:12.637522+00:00", "lang": "en", "topics": ["developer-tools", "ai-agents", "ai-products"], "entities": ["Iruka", "Claude", "Grok", "Kimi", "KDE Dolphin", "macOS"], "alternates": {"html": "https://wpnews.pro/news/your-ai-coding-agent-is-working-in-a-folder-you-can-t-see", "markdown": "https://wpnews.pro/news/your-ai-coding-agent-is-working-in-a-folder-you-can-t-see.md", "text": "https://wpnews.pro/news/your-ai-coding-agent-is-working-in-a-folder-you-can-t-see.txt", "jsonld": "https://wpnews.pro/news/your-ai-coding-agent-is-working-in-a-folder-you-can-t-see.jsonld"}}