use-cases / ci-cache-without-s3 / hero

FILES · CACHE · COST-OPTIMIZE

The CI cache that's not an S3 line item

Most CI pipelines burn money on cache traffic — push artifacts to S3, pull them back next job, pay for storage, pay for egress, pay again when runners shift region. On Hoody the cache is a folder on the same bare metal that runs your build container. Push a tarball with curl. Pull it with curl. The bytes never leave the box.

Read the Files API

files.containers.hoody.com · audit

https://files.containers.hoody.com/cache-audit/last-30-dayslive

total cache47.2 GBacross 47 entries

hit rate · 30 d94%11.4M GETs · 412k PUTs

monthly billincluded$78/mo on S3

/files/cache · last 30 days10 of 47 shown

· node_modules-2026-05-04.tar.zst312 MB47×
· target-rust-debug.tar.zst1.4 GB12×
· cypress-binary-cache.tar.zst247 MB208×
· playwright-browsers.tar.zst612 MB94×
· go-mod-cache.tar.zst184 MB63×
· docker-layers-base.tar.zst2.1 GB31×
· pip-wheelhouse.tar.zst96 MB118×
· yarn-offline-mirror.tar.zst428 MB76×
· next-build-cache.tar.zst176 MB29×
· swift-derived-data.tar.zst1.1 GB8×

atime prune · nightlyok · −5.4 GB last run

what S3 would have charged

Storage · GB-month$1.0947.2 GB × $0.023
Egress · GB out$127.801.42 TB × $0.090
PUT requests$2.06412k × $5/M
GET requests$4.5611.4M × $0.40/M
CloudFront / NAT−$57.71cross-AZ pull

total / month$78.04

the same 47.2 GB of cache · two different invoices

use-cases / ci-cache-without-s3 / mechanism

Three curls and a cron

The whole CI cache is three commands and one cleanup job. PUT to write a tarball. GET to read it. find -atime to prune. There is no fourth piece — no IAM policy, no bucket lifecycle, no signed URL ceremony.

WRITE

Compress and PUT

After install, the runner streams node_modules through tar | zstd into a single PUT against /files/cache. Hoody writes the body to disk as one binary blob. No multipart, no part-uploader, no SDK.

# After yarn install, push the artifacttar c node_modules | zstd -T0 | curl -T - https://files.containers.hoody.com/cache/$KEY.tar.zst

READ

GET and untar

The next job's first step is one curl. The body comes off NVMe at line rate because the cache lives on the same physical box as the runner — no egress hop, no cross-AZ pull, no CloudFront edge.

# Next job: pull and untar in one linecurl -fsS https://files.containers.hoody.com/cache/$KEY.tar.zst | tar x -I zstd

PRUNE

find -atime · nightly

Hoody Cron fires once a night. find /files/cache -atime +30 -delete throws out anything no job has read in a month. No retention policy, no Glacier tier, no lifecycle JSON to maintain.

# Nightly cron — anything unread in 30d is gonefind /files/cache -atime +30 -delete

PUT writes. GET reads. find prunes. The Hoody Files API is the cache server, the cleanup engine, and the audit log — all behind the same /files/[path] URL.

use-cases / ci-cache-without-s3 / powers

Three powers of cache-as-folder

Pushing the cache out to a separate vendor used to make sense when storage was scarce. On a bare-metal container, it just adds a vendor.

ECONOMICS

No GB-month, no egress, no requests

S3 charges three meters: storage, egress, and per-request. Hoody Files is included in the flat-rate server price — the disk you already rent is the disk the cache sits on. The bytes never cross a billing boundary.

LATENCY

NVMe instead of cross-region

Reads come off the same physical box that runs the build. There is no S3 endpoint to resolve, no TLS handshake to a region, no rate limit on prefix throughput. A 1.4 GB Rust target unpacks in seconds.

OWNERSHIP

One vendor relationship, not two

Your runner and your cache live on the same instance, billed on the same invoice, debugged with the same SSH session. When you turn the container off, the cache is the disk image — back online the moment you boot it.

use-cases / ci-cache-without-s3 / invoice

What evaporates from the bill

A typical mid-size CI footprint moves about 1.4 TB of cache traffic per month. Here is the line item it builds on AWS; on Hoody the cache runs inside the flat-rate server you already pay for.

BEFORE · S3 INVOICEthis month, on AWS

Storage · GB-month$1.0947.2 GB × $0.023
Egress · GB out$127.801.42 TB × $0.090
PUT requests$2.06412k × $5/M
GET requests$4.5611.4M × $0.40/M
CloudFront / NAT−$57.71cross-AZ pull

monthly total$78

five line items · five rates · one bucket

AFTER · HOODY FILESthis month, on Hoody

Disk on the serverno extra chargecovered by the flat monthly server price
Egress between jobsno extra chargeloopback · stays on the box
PUT / GET requestsno per-request or per-GB meterno per-request meter
Vendor relationshipno extra chargethe runner and the cache are one invoice
47.2 GB usedof planheadroom on the same server disk you already rent

monthly totalincluded in server price

one disk · one bill · zero new vendor

When the cache lives on the box that runs the build, the meter S3 was running has nothing to read. The line item doesn't move because there is no transaction to bill.

use-cases / ci-cache-without-s3 / capacity

What the Files endpoint guarantees

Hoody Files isn't a thin wrapper — it's a real persistent backend with hashing, history, range reads, and an audit journal. The CI cache uses a thin slice of what's actually exposed.

ONE URL · ANY ARTIFACT/files/[path]
PUT to write, GET to read, HEAD for ETag and Content-Length, ?hash for SHA256, ?stat for metadata. The cache is the same endpoint family that powers logs, builds, and shared artifacts.
TIME-TRAVEL READS?at · ?revision
Every write goes through the file journal. Pull yesterday's cache by timestamp or by per-path revision number — debugging a flake stops requiring a separate snapshot tool.
MOUNT WHEN YOU OUTGROW IT60+ backends
If the cache really does need to live in S3, B2, or a Drive folder, mount it as a backend and keep the same /files/[path] URL. The runner code never changes — the cache just moves.

Numbers reflect the published Hoody Files API surface — `GET/PUT/HEAD/PATCH /api/v1/files/[path]`, the `?hash`/`?stat`/`?at`/`?revision`/`?history` query parameters, and the file journal endpoints under `/api/v1/journal`.

use-cases / ci-cache-without-s3 / punchline

Your CI cache stops being a separate vendor. It's a folder on the box you already rent.

yesterday · five ratestoday · one disk

WHAT THE OLD BILL HADS3 bucket + egress + requests + lifecyclefive line items · separate IAM · separate vendor

WHAT IT IS NOWPUT /files/cache/$KEY · GET /files/cache/$KEYtwo curls — and the cache is the runner's own disk

Read the Files spec

use-cases / ci-cache-without-s3 / replaces

What this replaces

The standard reach-for-it cache backends each charge you a vendor relationship, an egress bill, or a per-build fee. /files charges you none of those.

AWS S3 bucket-as-cacheStorage, egress, requests — three meters for a tarball you keep two days
GitHub Actions cache10 GB free, then per-GB fees and a 7-day eviction you can't tune
BuildJet cachePer-runner pricing for storage that lives off the runner anyway
Bazel remote cache servicesA whole second daemon and a cache protocol to babysit
Turborepo Remote CachePer-build pricing for a tarball your monorepo already produced
Earthly Cloud cacheA managed remote backend for what is just curl + tar

use-cases / ci-cache-without-s3 / cta

Stop renting a cache from a second cloud. Write the tarball to the disk you already pay for, and curl it back.

Read the Files API

use-cases / ci-cache-without-s3 / related

Read the others

Sixty containers on one server

One bare-metal box runs dozens to hundreds of Hoody containers. KSM and BTRFS dedup make the marginal cost near zero.

Containers·Snapshots

Onboard a developer with one link

A new engineer joins on Monday. You send one URL. They open it on whatever laptop they have and they're in a fresh container cloned from your developer-baseline snapshot — code, deps, env, seed data, VSCode-in-browser. Writing code in five minutes, not setting up.

Snapshots·Containers·Terminal·Files

API endpoints that materialize on demand

A wildcard exec script catches the call, asks an LLM to write the handler, runs it in a V8 sandbox, and saves the route. The next call is native.

Exec·Agent·Code·Files

Branch computers like Git

Snapshot a running container — files, processes, memory. Restore in seconds. Fork via /copy. Branching, but for the entire machine.

Snapshots·Containers

Real VS Code on your phone

The Code Orchestrator spawns a VS Code instance on the container and serves the editor over a normal HTTPS URL. Any device with a browser can open it. The work lives in the container, not on the device.

Display·Terminal·Files·Containers+1

AI agents that spawn other AI agents

A research agent posts to /api/v1/projects/$PID/containers to start a child container, then calls the child's agent URL like any other HTTP service. Sub-agents spawn their own sub-agents the same way. No orchestrator framework, just URLs.

Agent·Exec·Containers

One sandbox per customer, automatically

An exec script catches your signup webhook, copies a fresh-customer container, and hands the new tenant their own URL. Isolation is the operating system, not a tenant_id column.

Containers·Snapshots·Exec·Files

Wake up to a finished prototype

Hand the agent a paragraph at midnight. It spawns its own containers, snapshots before risky steps, and posts to your notification webhook at sunrise.

Agent·Snapshots·Containers·Browser+2

Emergency production fix from your phone

PagerDuty wakes you. Open the terminal URL on your phone. PATCH the snapshot from before the bad deploy. Production is back. No bastion, no VPN, no laptop.

Terminal·Snapshots·Network

Tail production logs to a URL anyone can curl

One pipe URL. Up to 256 readers. Three engineers tail the same incident at once with no bastion, no Datadog seat, no log forwarder.

Pipe

Push one build to thirty CI workers at once

The build container streams the tarball to a pipe path with ?n=30. All thirty test workers curl the same URL. Bytes go through once, fanned out.

Pipe

Watch your agent think from the coffee shop

Your agent runs at home. You're at a café. Pipe each event of the loop through Hoody Pipe and curl the same path from your phone — the trace lands character by character. No SSH, no dashboard, no upload.

Pipe·Agent

Move 200GB between clouds with two curls

pg_dump | gzip | curl from Frankfurt. curl | gunzip | psql in Singapore. Bytes flow through the pipe with zero disk in the middle.

Pipe

Send a teammate a database state in one line

pg_dump streams straight into their psql. No file uploaded, no link shared, no download. The pipe routes the bytes through.

Pipe

Stream LLM tokens to anything that reads HTTP

Step 3 streams tokens with curl -T -. Step 4 curls the same path. Tokens move generator to consumer at line speed. No SSE plumbing, no broker.

Pipe·Agent

A progress bar your boss can spectate without joining

Append ?progress to the pipe URL. Anyone who opens it gets a live HTML dashboard — bytes, speed, ETA, state. Up to fifty spectators, none consuming a receiver slot, none touching the stream.

Pipe

The webhook fan-out you didn't have to build

Stripe POSTs to a pipe path with ?n=12. Twelve subscribers curl the receiver URL with ?n=12. The pipe holds the event until everyone is connected.

Pipe·Exec

A CI cache that's just two curl commands

tar | zstd | curl puts node_modules into a pipe. Twenty downstream jobs curl | zstd -d | tar x. No S3 bucket, no cache action, no egress bill.

Pipe·Containers

Drag-drop uploads into your script

hoody-pipe serves a web upload form at every path. Drag a file onto the page, your script reads the bytes from stdin. Zero upload code, no S3 bucket, no presigned URLs.

Pipe·Exec

Broadcast a workshop to 200 viewers from your laptop

ffmpeg streams your screen to a pipe path with ?n=200. Each attendee curls the URL into a browser tab. No platform, no logins, no upload.

Pipe

Inter-container IPC without the message broker

Container A writes to a pipe path. Container B reads from the same path. Backpressure is the connection. No Redis, no queue, no broker.

Pipe·Containers

Tail your agent on the train, get pinged when it lands

The agent streams its trace to a pipe path you can curl from your phone. When it finishes, its last act hits hoody-notifications and your phone buzzes. Two URLs and a buzz — no SDK, no client app, no dashboard.

Pipe·Agent·Notifications

A microphone over HTTP, in two terminals

ffmpeg captures the mic, pipes to a URL. The other end curls and plays the audio. No Zoom, no SDK, no signaling server.

Pipe

Five agents, five pipes, one verdict

A panel of five models reviews the same input. Each runs in its own container and streams its verdict to its own pipe path. A judge process curls all five in parallel and tallies the result.

Pipe·Agent·Containers

Replay this morning's incident to the whole team

Snapshot the incident-time logs in hoody-files. Replay them through a Hoody Pipe URL with ?n=8. Eight engineers curl the same path and watch the cascade fire in lockstep — the post-mortem is a synchronized stream, not a Confluence doc.

Pipe·Files

The fastest 'send me that file' you've ever typed

A teammate pings for a 4 GB dump. Slack rejects it, Drive needs a share request. You type curl -T file …; they type curl … > file. The bytes move directly between disks — no upload bar, no link to share.

Pipe

Run a local LLM, serve it to your whole fleet

One GPU runs llama.cpp. Its tokens stream into a pipe path with ?n=50. Fifty containers curl the same URL and split the stream.

Pipe·Daemon

A live metrics dashboard with no metrics backend

Each container's monitoring loop curls a metric to a pipe URL. The dashboard curls the same URL with ?progress and renders the SSE stream.

Pipe

The cron job that deletes itself when you're done

POST a managed cron entry with expires_at set 48 hours out. The job runs on schedule, then removes itself — no reminder, no cleanup PR, no stale entry.

Cron

Snapshot the container right before the nightly migration

A hoody-cron entry that fires at 02:55 UTC, curls the snapshots URL, and names the artifact pre-migration-2026-05-04. Five minutes later the migration runs. If it succeeds, the snapshot sits idle and costs nothing. If it fails, you restore in 30 seconds with a single PATCH.

Cron·Snapshots

A separate crontab for every customer, automatically

Each tenant gets their own container and their own hoody-cron service. Customer A's 9am digest fires on time even when customer B's job hangs for 40 minutes, because they aren't on the same crontab.

Cron·Containers

Wake an agent at 3am, retire it at 4

A nightly cron POSTs a spawn request, the agent does its hour of work, then a second cron tears the container down. The agent exists only when there is work for it to do.

Cron·Agent·Containers

Daily rollups without an orchestrator

Raw events pile up in a sqlite URL. Every night a cron entry curls an exec endpoint, the script runs the rollup SQL, writes the daily table back. No DAG, no Airflow Postgres, no scheduler dashboard.

Cron·SQLite·Exec

A crontab per branch, deployed with the code

Your repo checks in `.hoody/crontab`. The deploy script PUTs that file to the new container's Cron API. Each branch gets its container, its filesystem, its schedule.

Cron·Containers

On-call escalation that ages out with the shift

POST a cron entry with expires_at = shift end. When the shift ends, the entry deletes itself. The next on-call posts their own.

Cron·Notifications

Hourly scrape, daily digest, weekly archive — one container

Three lines in one crontab: hourly browser scrape into SQLite, daily exec digest, weekly archive to files. Flat-rate server, three rhythms, no scheduler service.

Cron·Browser·SQLite·Files

Let your customers BYO their own cron schedule

Customers POST their own 5-field expressions; their crontab lives in their container, isolated. You don't validate against a global queue.

Cron·Containers

Schedule the agent, not the script

A 5-field cron entry curls hoody-agent with a prompt instead of running a fixed script. Today is the last day of the month — the agent figures it out. The data shape changed — the agent figures it out.

Cron·Agent

A heartbeat for the silent jobs

Each cron run POSTs a heartbeat to a notifications endpoint. A second cron checks last-heartbeat and pages on silence. Silence is the alert.

Cron·Notifications

Keep the last 24 hours as 24 snapshots

An hourly cron POSTs a snapshot named with the hour. After 24 hours each new snapshot overwrites yesterday's at the same hour. The 24-floor time machine.

Cron·Snapshots

Replay this morning's webhooks at the same time tomorrow

You captured 30 minutes of real Stripe traffic into a hoody-files folder. One cron entry replays it against staging at 9am every weekday — same volume, same payloads, same time-of-day pressure.

Cron·Files·Exec

Edit your crontab from a phone, in the airport

Open the cron URL on your phone in the gate area. Tap a row, change a single field of the cron expression, hit Save. PATCH lands. The job fires tonight on the new schedule. No SSH session, no jump box, no laptop.

Cron·Terminal

A scheduled digest that fans out to 200 inboxes

Cron at 9am POSTs to an exec script that builds the digest and curls a pipe URL with ?n=200. Two hundred recipients hit the same URL once.

Cron·Exec·Pipe

Mute the flaky job without losing it

PATCH /entries/[id] [ enabled: false ]. The job stays in your crontab waiting to be fixed. No deletion, no rewrite, no lost context.

Cron

An agent that grades yesterday's agents

A nightly cron POSTs to the supervisor agent with yesterday's agent traces from SQLite. The supervisor scores each one. Cron is the supervisor.

Cron·Agent·SQLite

Cleanup jobs that schedule their own retirement

The cleanup script checks if there's anything left to clean. When the directory is empty, it DELETEs its own cron entry. Job's done, job's gone.

Cron·Files

Roll your TLS certificates without an SSH session

Cron weekly: POST to an exec script that runs certbot, posts the new cert to the proxy via PATCH. No shell session, no key, no jump host.

Cron·Exec

A weekly canary that tries to break production

Sunday 7am cron wakes a Hoody Agent in a fresh container against a snapshot of prod. It runs the OWASP top twenty, fuzzes the API, and writes a findings report to a URL by 9am. Container retires.

Cron·Agent·Browser·Snapshots

The hobby-project graveyard you can afford to keep alive

Eleven half-finished side projects on Heroku is eleven dynos at $5–7 each. On Hoody it's eleven containers on one $29 bare-metal box. Idle costs zero, the URL wakes the container in milliseconds, and the chess engine nobody uses still runs.

Containers

A preview environment per pull request, all month

Each open PR gets its own clone of a snapshot. The container wakes when reviewers click the link; idle PRs cost nothing.

Containers·Snapshots

Run a 12-product portfolio from one bare-metal box

Twelve isolated containers, each its own SaaS, share one $49 bare-metal server — a step above the $29 entry tier, chosen here for the RAM headroom fifty containers want. Per-product margins go from negative to nice.

Containers

Kill the staging-server tax

Stop paying for a duplicate of production. Snapshot the prod container, branch staging from it on demand, freeze it back to disk when nobody's testing. Three environments, one machine, one bill.

Containers·Snapshots

Forty client sites, one rent, one dashboard

Each client site lives in its own container; you bill them per-site, you pay the host once. The math finally works for agencies.

Containers·Workspaces

Replace the E2B bill with the bare metal you already rent

Your agents stop renting compute by the second from E2B/Modal/Daytona. They use containers on the box you already have.

Containers·Agent·Exec

Idle staging costs nothing, so staging stops getting deleted

Staging used to die because it was expensive to keep around. When idle is free, staging gets to live — even the one a teammate touched 90 days ago.

Containers·Snapshots

Per-customer sandboxes at fleet scale

Eight hundred isolated customers on three bare-metal servers — one flat-rate monthly bill, no per-tenant meter. Each tenant gets a real container with its own kernel namespace, filesystem, and URL. Idle containers cost nothing on top of the server you already pay for.

Containers·Snapshots·Exec

Fifty demo environments for fifty sales calls

Each prospect gets a real, isolated copy of your product seeded with their data. Cloned from a snapshot. Theirs to keep for a week.

Containers·Snapshots

The CI cache that's not an S3 line item

Three curls and a cron

Compress and PUT

GET and untar

find -atime · nightly

Three powers of cache-as-folder

No GB-month, no egress, no requests

NVMe instead of cross-region

One vendor relationship, not two

What evaporates from the bill

What the Files endpoint guarantees

What this replaces

Read the others

Sixty containers on one server

Onboard a developer with one link

API endpoints that materialize on demand

Branch computers like Git

Real VS Code on your phone

AI agents that spawn other AI agents

One sandbox per customer, automatically

Wake up to a finished prototype

Emergency production fix from your phone

Tail production logs to a URL anyone can curl

Push one build to thirty CI workers at once

Watch your agent think from the coffee shop

Share your screen with a URL, not a meeting invite

Move 200GB between clouds with two curls

Send a teammate a database state in one line

Stream LLM tokens to anything that reads HTTP

A progress bar your boss can spectate without joining

The webhook fan-out you didn't have to build

A CI cache that's just two curl commands

Drag-drop uploads into your script

Broadcast a workshop to 200 viewers from your laptop

Inter-container IPC without the message broker

Tail your agent on the train, get pinged when it lands

A microphone over HTTP, in two terminals

Five agents, five pipes, one verdict

Replay this morning's incident to the whole team

The fastest 'send me that file' you've ever typed

Run a local LLM, serve it to your whole fleet

A live metrics dashboard with no metrics backend

The cron job that deletes itself when you're done

Snapshot the container right before the nightly migration

A separate crontab for every customer, automatically

Wake an agent at 3am, retire it at 4

Daily rollups without an orchestrator

A crontab per branch, deployed with the code

On-call escalation that ages out with the shift

Hourly scrape, daily digest, weekly archive — one container

Let your customers BYO their own cron schedule

Schedule the agent, not the script

A heartbeat for the silent jobs

Keep the last 24 hours as 24 snapshots

Replay this morning's webhooks at the same time tomorrow

Edit your crontab from a phone, in the airport

A scheduled digest that fans out to 200 inboxes

Mute the flaky job without losing it

An agent that grades yesterday's agents

Cleanup jobs that schedule their own retirement

Roll your TLS certificates without an SSH session

A weekly canary that tries to break production

The hobby-project graveyard you can afford to keep alive

A preview environment per pull request, all month

Run a 12-product portfolio from one bare-metal box

Kill the staging-server tax

Forty client sites, one rent, one dashboard

Replace the E2B bill with the bare metal you already rent

Idle staging costs nothing, so staging stops getting deleted

Per-customer sandboxes at fleet scale

Fifty demo environments for fifty sales calls