Reference
Settings and where data lives
What each settings tab holds, and where your data physically ends up. Use this page to answer “where was that setting?” and “what should I save before I change this?”
The settings tabs
Settings are grouped into three sections.
Account and AI
| Tab | What it covers |
|---|---|
| Connections | AI engines and API keys (connection guide) |
| Models | Default models per mode |
| Usage | Tokens and generation limits |
| Profile | Company details and per-client profiles |
Workspace
| Tab | What it covers |
|---|---|
| Appearance & input | Language, theme, input behaviour |
| Safety | Approval and compliance policy |
| Data | Storage location, exporting, deletion |
| Team sharing | Collaborating through a shared folder (sharing guide) |
System
| Tab | What it covers |
|---|---|
| About | Version and updates (update guide) |
| Self-agent | Learning and visualising your working style (digital twin) |
Appearance and input
| Setting | What it does |
|---|---|
| Language | The interface language. The AI answers in this language too |
| Theme | Light or Dark |
| Font size (whole app) | Overall text size |
| Compact display | Increases information density |
| Show “Compositions” (video editing) | Off hides compositions and the phone link from the sidebar. Nothing is deleted |
| Sidebar width | Width of the left column |
| Send key | Enter to send or ⌘+Enter to send |
Safety
Approval mode for tool execution applies to both Claude and ChatGPT.
| Mode | Behaviour |
|---|---|
| Ask every time | A dialog before generation and before touching folders outside the working directory |
| Auto approve | Automatic inside the working folder |
| Bypass | Fully automatic, full access |
The same tab carries policies that are passed to the AI at generation time:
- Confirm before sending confidential data externally
- Add an AI-generated label by default
- Use only commercially cleared material and wording
Model defaults
You can set a default engine and model per mode, for each stage of the work. Anything you pick in the composer is an override for that moment. Only connected engines are listed.
| Stage | What it covers |
|---|---|
| Thinking engine | Reasoning and judgement |
| Prompt building | Composing the instruction for a generator |
| Image / video generation | The generation itself |
| Body writing | Article and long-form text |
| Narration / music | Audio generation |
| Implementation engine | Writing code |
Models can also be pinned per role in an AI team — a strict model for the reviewer, a fast one for the writer. Auto-continue limit for work mode (times) lives on this tab as well.
Usage
Shows input and output tokens per engine and period, the API-equivalent cost, and the number of runs. Periods are Today, 7 days and 30 days.
As the app notes: Claude and GPT run through subscription sign-in, so there's no additional charge. The amount shown is what it would have cost via API, for reference only.
The same tab sets generation caps and the low-credit warning (details).
Profile
Register a company name and logo for branding deliverables. You can also save a set of settings per client and switch between them. SMTP email settings live on this tab too.
Where your data lives
The default storage folder is ~/Documents/WorkPilot, changeable under
Settings → Data → Storage folder (output and logs).
The main folders are:
| Folder | Contents |
|---|---|
knowledge-base/ | Knowledge — one folder each, Markdown in OKF format |
skills/ | Skills |
notes/ | Notes |
generated/ | Generated images and video |
narration/ / bgm/ / recordings/ | Narration, music, recordings |
作品/ | Exported video and Premiere exports |
成果物/ | Deliverables produced by the work |
received/ | Material received from your phone |
exports/ | Anything you exported |
logs/ | Operation logs |
.appdata/ | The app's internal data |
Running in development mode uses ~/Documents/WorkPilot-dev, isolated from your real data.
How secrets are stored
API keys and passwords are encrypted into this Mac's keychain rather than written into the folder. The key itself never appears on screen or in a file, and secrets are never written into a shared folder.
Backups and restoring
Conversations and settings are backed up automatically every day (around 10 MB per generation). Everything including generated media is also versioned on the same disk, using a method that doesn't duplicate files, so it barely consumes space. The first run happens five minutes after launch.
Open Settings → Data → Backup.
For a manual one, press Back up now.
To go back, choose a date under Conversation history versions (click to restore) and press Restore this day.
Restoring sets the current state aside automatically, so you can undo it.
The app restarts to apply the change. To recover individual files, use
Open backup folder and look inside full/date.
Exporting and deleting
| Action | Where | What it does |
|---|---|---|
| Export a thread as Markdown | Thread menu | 📤 Export this thread |
| Export knowledge as OKF | Knowledge screen | A Markdown folder you can hand to other AI tools |
| Export all media | Settings → Data | Export video and attachments from all threads |
| Delete all history | Settings → Data | Delete all thread history |
Deleting all history asks twice (Really delete (press again)). Take a backup and export anything you need before running it.