Get started
Where things live
JARVIS Ultra keeps everything in two places: its own folder (~/jarvis-ultra, on Windows %USERPROFILE%\jarvis-ultra, unless you chose another), and Hermes' home folder. Nothing is stored in the cloud.
The JARVIS Ultra folder
| Folder | What it holds |
|---|---|
data/ |
Your database, settings, keys and backups. Only your user can read it. Never share it or put it in git. |
docs/ |
The team's documents, one folder per author: docs/orchestrator/, docs/researcher/, and docs/you/ for what you write. |
logs/ |
jarvis.log (the server's log), service.log (start-up output) and turns/ (what Hermes printed for each agent turn). |
api/, web/, scripts/ |
The program itself. Running the install line again updates these through scripts/update.py, which replaces only the files listed in release-files.txt (Update, restart and uninstall). |
.previous/ |
The files the last update replaced or removed, kept until the next update |
manual/ |
This manual. |
The most useful files in data/:
| File | What it is |
|---|---|
data/jarvis.db |
Conversations, missions, the board, schedules, rules, approvals and usage |
data/backups/ |
Backups made in Settings > Backups |
data/owner.yaml |
Your brief, as saved from Meet your team or Settings > General |
data/provider-<name>.key |
Each provider key you added in Settings > Models |
Hermes' home folder
| System | Folder |
|---|---|
| macOS and Linux | ~/.hermes |
| Windows | %LOCALAPPDATA%\hermes |
The Orchestrator's files sit at the top of that folder. Every other agent has its own folder under profiles/<name>/, and a retired agent's folder moves to profiles-archived/<name>/. Each agent's folder holds its identity (SOUL.md), its memories (memories/MEMORY.md, memories/USER.md), its settings (config.yaml) and its skills (skills/). You can edit the first four from the agent's drawer on Team (Edit an agent's identity and memory).
The service
| System | Where the service is defined |
|---|---|
| macOS | ~/Library/LaunchAgents/com.jarvis-ultra.app.plist |
| Linux | ~/.config/systemd/user/jarvis-ultra.service |
| Windows | The Scheduled Task com.jarvis-ultra.app, with its files in %LOCALAPPDATA%\jarvis-ultra\services |
Every file and folder is listed in Files and folders.