Filesystem Reference

Your agent’s persistent storage is mounted at /data. This reference documents all standard directories and files.

Directory structure

/data
├── MEMORY.md              # Agent's persistent memory
├── config.json            # Agent preferences (model, etc.)
├── skills/                # Custom per-agent skills
├── sessions/
│   └── {id}.jsonl         # Conversation history files
├── outbox/
│   ├── email/             # Pending outgoing emails
│   ├── sent/              # Successfully sent emails
│   └── failed/            # Failed email attempts
└── events/
    └── {name}/            # Scheduled event files

Core files

MEMORY.md

Your agent’s persistent memory. Read at the start of every turn on every channel.

Default contents:

# agentname — Agent Memory

## Identity
- Email: agentname@tinyfat.com
- Owner: you@example.com

## Email Response Pattern
To send an email, write a JSON file to /data/outbox/email/:
...

## Rules
[Default behavior rules]

Best practices:

• Keep it focused — it’s read every turn
• Use for persistent preferences and context
• Don’t store large data here

config.json

Agent configuration and preferences:

{
  "model": "sonnet"
}

Fields:

• model — Claude model to use (haiku, sonnet, opus)

Default model is claude-sonnet-4-6. Change via /model command or ask your agent.

Sessions directory

/data/sessions/ contains conversation history files.

Session file format

JSONL (JSON Lines) format, one entry per line:

{"role":"user","content":"Hello!","timestamp":"2026-01-04T12:00:00Z"}
{"role":"assistant","content":"Hi! How can I help?","timestamp":"2026-01-04T12:00:05Z"}

Session ID and hash

Each session has:

• ID — Full UUID (e.g., a1b2c3d4-e5f6-7890-abcd-ef1234567890)
• Hash — First 4 characters (e.g., a1b2)

Use the hash with /resume a1b2 to continue a session.

Listing sessions

Send /resume (no argument) to get a list of recent sessions.

Outbox directory

/data/outbox/ is where your agent writes outgoing emails.

email/

Pending emails waiting to be sent. Agent writes JSON files here:

{
  "to": ["recipient@example.com"],
  "cc": ["cc@example.com"],
  "subject": "Email subject",
  "body": "Email body text",
  "in_reply_to": "<message-id@example.com>",
  "references": "<msg1@example.com>",
  "attachments": [
    {
      "filename": "report.pdf",
      "content": "base64-encoded-content"
    }
  ],
  "status": "pending"
}

sent/

Successfully sent emails are moved here with metadata:

{
  ...original fields...,
  "status": "sent",
  "sent_at": "2026-01-04T12:00:00Z",
  "resend_id": "abc123"
}

failed/

Emails that couldn’t be sent after retries:

{
  ...original fields...,
  "status": "failed",
  "error": "Error message",
  "failed_at": "2026-01-04T12:00:00Z"
}

Events directory

/data/events/ stores scheduled event files. Your agent can create events that fire on a cron-like schedule. The platform wakes the container at the right time, even if it’s asleep.

Skills directory

/data/skills/ is for custom per-agent skills. Files here override system skills of the same name.

Three-tier priority:

1. System skills (/opt/fat-skills/) — lowest
2. Workspace skills (/data/skills/) — middle
3. Channel-specific skills — highest

Container directories

Besides /data, the container has:

Path	Purpose
/opt/fat-skills	Platform skills (browser-tools, gh-login, pdf-gen)
/opt/troublemaker	Agent runtime (troublemaker)

Pre-installed tools

Available in the container:

Tool	Command	Notes
Git	git	Version control
HTTP	curl, wget	Network requests
JSON	jq	JSON processing
YAML	yq	YAML processing
Search	rg (ripgrep)	Fast text search
Find	fdfind	Fast file finding
Tree	tree	Directory visualization
SQLite	sqlite3	Database
PostgreSQL	psql	Database client
Python	python3, uv	Python + package manager
Node	node, npm	JavaScript runtime
GitHub	gh	GitHub CLI
Browser	browser-nav.js, browser-screenshot.js, browser-eval.js	Headless Chrome

Data access

Via any channel

Ask your agent: “Show me the contents of /data/MEMORY.md”

Via dashboard

File browser coming soon.

Via export

Contact support for R2 data export.