.ship/ Directory

.ship/ is ShipMyAgent's local runtime data directory. In most projects, it should not be committed to Git.

Typical layout

.ship/
  logs/
  context/
  memory/
  chat/
  task/
  config/
  schema/
  public/
  profile/
  .cache/

Key folders

.ship/logs/

Daily JSONL logs: <YYYY-MM-DD>.jsonl.

.ship/context/<contextId>/messages/

Conversation source-of-truth (messages.jsonl) with compact metadata/archive.

.ship/memory/

Memory V2 storage:

• MEMORY.md for long-term facts/preferences.
• daily/<YYYY-MM-DD>.md for append-only daily memory.
• index.sqlite for local FTS index (rebuildable).

.ship/chat/

Chat metadata and history event stream.

.ship/task/

Task definitions and per-run artifacts (run.json, result.md, etc.).

Skills location

Skills are discovered from .agents/skills (project) and ~/.agents/skills (user).

Security guidance

• .ship/ may contain sensitive conversations and execution traces.
• For debugging, prioritize logs, task, and context.