Everything is a file

One address, one file.

A world, a device, a run, a monitor and a setting are each a plain file. Every reference points at a file by its ref.

The ontology

Every arrow ends at a file.

A unit names its definition, a run names the file it is of, a grant names a world by its address. Nothing is merged by a global id.

Every reference is a ref to a fileA standing grant names a world by its absolute address. A world's unit names its device definition by ref. A run's run.json names the file it is of, and its streams are folders of growing records beside it. A monitor imports the file it builds on by a relative path.namesindevice=importA standing grantworld: an absoluteaddressrun.jsonof: ../../world.tsxA streamrecords.jsonl, grows onlyworld.tsxworlds/fleet/monitor.tsxcapital/grants-gov/definition.tsxa device and its channelsfaucets.tsxcapital/Every reference is a ref to a fileA standing grant names a world by its absolute address. A world's unit names its device definition by ref. A run's run.json names the file it is of, and its streams are folders of growing records beside it. A monitor imports the file it builds on by a relative path.namesindevice=importA standing grantworld: an absoluteaddressrun.jsonof: ../../world.tsxA streamrecords.jsonl, growsonlyworld.tsxworlds/fleet/monitor.tsxcapital/grants-gov/definition.tsxa device and its channelsfaucets.tsxcapital/

A run is a folder you can read.

This is one run in CommandAGI's own Drive, as it is stored: five plain files. Its run.json names the monitor file it is of. Its streams only grow.

Read on 2026-11-04 by scripts/sites/case-studies.mjs, from the production Drive. The hlc and salt fields of each line are left out here.

cloud://home/user-commandagi/runs/thread-idempotent-thread-user-commandagi-monitor-capital-grants-gov/real files · production · 2026-11-04
run.json                             516 B   "description": "monitor: capital/grants-gov · file: cloud://home/user-commandagi/capital/grants-gov/monitor.tsx"
members.jsonl                        255 B   08:54:52.075 event join agent:2eff25af… privileges observe, state.read, submit, interact
streams/effects@cloud/stream.json    213 B
streams/effects@cloud/records.jsonl  784 B   09:59:49.096 event intent effect=trigger due 2026-11-04
streams/chat@cloud/records.jsonl    1257 B   09:59:52.467 event line "Trigger monitor:capital/grants-gov:wake:grants-gov.opportunity fired"

Counted in the Drive

318,823 files, no database of them.

CommandAGI's own account, cloud://home/user-commandagi/ in production, listed file by file on 2026-11-04 (48.8 GB). The numbers are in case-studies/everything-is-a-file/stats.json in that Drive.

A file is the record. A run's streams are its record. There is no second copy in a table that could disagree with them. Code is the document. A world, a 3D part, a schematic and a task are .tsx files. The editors write each edit back into the code.

files in CommandAGI's Drive
318,823
in all
48.8 GB
runs, each a run.json
13,046
monitors, each a monitor.tsx
12,104
Files by kind in CommandAGI's Drive
Os números
Files by kind in CommandAGI's Drive
Kind of fileFiles
streams13610
runs13046
monitors12104
.3d.tsx345
settings.json246
.task.tsx52
.sch.tsx20
world.tsx3
ProvenanceFile cloud://home/user-commandagi/ (production)Output case-studies/everything-is-a-file/stats.jsonTool scripts/sites/case-studies.mjs everything-is-a-fileRan on This computer (dell-gb10-1), reading the production DriveWhen

Open a folder. It is the project.

Every pane is in a folder of a drive, and offers the files along its search path.