JARVIS UltraManualv1.31

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.