File Layout
Where OpenVesper stores everything on disk. All paths under ~/.openvesper/ are mode 0700 (directories) or 0600 (files).
User directory tree
~/.openvesper/
├── config.json # default agent, installed lists
├── workspace/
│ └── sessions/
│ └── <safe-key>.json # one file per session
├── agents/ # user-installed agents
│ └── <mode>/
│ ├── SOUL.md
│ ├── IDENTITY.md
│ ├── USER.md
│ ├── TOOLS.md
│ ├── HEARTBEAT.md
│ ├── MEMORY.md
│ ├── memory/ # active memory entries
│ │ └── m_<id>.json
│ └── skills/
│ └── <name>/SKILL.md
├── tokens/ # OAuth tokens
│ └── <provider>.json
├── tasks/ # background tasks
│ └── t_<id>.json
├── audit/ # daily JSONL logs
│ └── YYYY-MM-DD.jsonl
├── plugins/ # user-installed plugins
│ └── <name>/
├── workspaces/ # additional gateway profiles
│ └── <name>/
│ ├── gateway.pid
│ └── agents/
├── workspaces.json
├── standing-orders.json
├── commitments.json
├── approvals.json
├── approval-rules.json
├── channel-routes.json
├── access.json
├── gateway.log
└── openvesper-diag-<ts>.json # diagnostics exportsRepo layout (bundled)
openvesper/
├── apps/
│ ├── cli/
│ ├── gateway/
│ ├── telegram-bot/ # separate process, user-installed
│ ├── vscode-extension/
│ └── website/ # docs + marketing
├── packages/
│ ├── core/
│ ├── plugin-sdk/
│ └── plugins/<name>/
├── .agents/ # bundled agent directories
│ └── <mode>/...
├── config/ # cron.yaml, webhooks.yaml templates
├── scripts/
└── test/File permissions
| Mode | Used for |
|---|---|
0600 | All session, token, memory, audit, config files |
0700 | Directories under ~/.openvesper/ |