Data Layout

~/.sorat/
├── config.json                     # Main configuration
├── user.md                         # User profile (name, timezone, country)
├── .cli_token                      # CLI auth token (created at startup)
│
├── agent/
│   └── persona.md                  # System prompt template (Go template)
│
├── sessions/
│   ├── index.json                  # Session registry
│   └── {uuid}/
│       ├── meta.json               # Session metadata
│       └── messages.json           # Message history
│
├── memory/
│   ├── facts.md                    # Timestamped facts
│   └── soul.md                     # Agent personality/values
│
├── workspace/                      # Agent file sandbox
│
├── skills/
│   ├── _state.json                 # Disabled skill names
│   └── {name}/
│       └── SKILL.md                # Skill definition (frontmatter + instructions)
│
├── cron/
│   └── jobs.json                   # Scheduled jobs with state and logs
│
├── auth/
│   └── credentials.json            # OAuth tokens (mode 0600)
│
├── logs/
│   └── YYYY-MM-DD.log             # Daily rotated JSON logs
│
└── tools/
    └── config.json                 # Tool configuration

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Chat about Go concurrency",
    "model": "gpt-4o",
    "created_at": "2025-01-15T10:00:00Z",
    "updated_at": "2025-01-15T10:30:00Z",
    "message_count": 12
  }
]

[
  {
    "role": "user",
    "content": "Hello!",
    "timestamp": "2025-01-15T10:00:00Z"
  },
  {
    "role": "assistant",
    "content": "Hi! How can I help you?",
    "timestamp": "2025-01-15T10:00:01Z",
    "tool_calls": []
  }
]

- [2025-01-15T10:30:00Z] User prefers dark mode
- [2025-01-15T14:00:00Z] Project uses Go 1.24

You are Sorat, running on {{.Hostname}} ({{.OS}}/{{.Arch}}).
...

---
name: my-skill
description: What this skill does
---

[Skill instructions]

[
  {
    "id": "job-uuid",
    "name": "hourly-check",
    "enabled": true,
    "schedule": {"kind": "every", "every_ms": 3600000},
    "payload": {"kind": "message", "message": "Check system health"},
    "state": {
      "last_run": "2025-01-15T10:00:00Z",
      "next_run": "2025-01-15T11:00:00Z",
      "run_count": 24,
      "last_status": "success"
    },
    "execution_log": [
      {
        "timestamp": "2025-01-15T10:00:00Z",
        "status": "success",
        "result": "System health is good.",
        "duration_ms": 4500,
        "tool_calls": 3
      }
    ]
  }
]

{
  "google-antigravity": {
    "provider": "google-antigravity",
    "access_token": "ya29...",
    "refresh_token": "1//...",
    "expiry": "2025-01-15T11:00:00Z"
  }
}

{"time":"2025-01-15T10:00:00.123Z","level":"INFO","msg":"server started","port":8080}