Nearbycoder avatar

Nearbycoder

Josh Hamilton
Resume

Project

agfs.dev

An open-source private filesystem for AI agents, with a web UI and CLI for uploading, previewing, and sharing remote artifacts through signed links.

Ongoing Creator
Visit project View code
TanStack StartTypeScriptCloudflare WorkersCloudflare R2Cloudflare D1Better AuthCLI

Impact

Turned the annoying problem of retrieving remote-agent artifacts into a simple upload, preview, and signed-link workflow that works across local machines, CI, and hosted agent environments.

agfs.dev is AgentFilesystem: a simple place for screenshots, logs, and other artifacts an agent needs to hand back.

AGFS screenshot

Why I built it

I have been spending more time running agent workflows on remote machines and hosted environments instead of keeping everything local on my MacBook.

That has real advantages:

  • the work keeps going after I close my laptop
  • remote environments usually have fewer local resource constraints
  • it is easier to isolate one-off workflows, tools, and experiments

The frustrating part starts when the agent produces a file I actually want to inspect.

At that point the workflow usually becomes some awkward combination of:

  • SSH into the box and manually pull the file down
  • ask the agent to stand up a temporary HTTP server
  • figure out port forwarding, bucket access, or some other one-off transfer path

That friction is what pushed me to build AGFS.

What AGFS gives me

  • A web app to browse files in one place
  • A CLI that works well for local machines, CI, and remote agent hosts
  • Signed preview links an agent can paste directly into chat
  • A cleaner handoff for screenshots, logs, outputs, and generated artifacts

The goal is not to invent a totally new category. The goal is to make a very common remote workflow feel obvious instead of improvised.

Why not Git

Most of the files I want to inspect are not source code.

They are usually artifacts:

  • screenshots
  • logs
  • generated media
  • exported reports
  • temporary debugging output

Those files are useful, but they are not things I want tracked in Git just because I need to look at them once or hand them from one workflow to another.

AGFS gives me a dedicated place for that layer.

How it is built

The app is built as a small Cloudflare-native system:

  • TanStack Start on Cloudflare Workers for the web app
  • R2 for file storage
  • D1 for metadata
  • Better Auth with GitHub auth for sign-in
  • A TypeScript CLI for upload, download, and share flows

That combination keeps the product fairly lightweight while still giving me a real web workspace plus a practical agent-facing CLI.

Install the CLI

If you want to try the remote workflow directly, the quickest path is:

npm install -g @agfs/cli
agfs login
agfs whoami

From there you can upload a file and get back a signed share URL:

agfs upload ./run/screenshot.png /runs/latest/screenshot.png --share 1h

For unattended agent or CI environments, AGFS also supports token-based auth through environment variables:

export AGFS_BASE_URL=https://agfs.dev
export AGFS_TOKEN=agfs_pat_...