Getting started

Beta

This page gives the shortest path from opening Wrengle to writing a first note.

Check download status

Open wrengle.com/download to check the latest GitHub release. The page offers only expected exact-named desktop assets uploaded in that release and marks a platform unavailable when its installer is absent. Linux is not a v1 shipping target.

Complete startup access checks

Wrengle checks the platform access needed by configured features before opening the workspace. On macOS, approve microphone and screen/system-audio capture when asked. Wrengle also preloads configured provider, account, integration, action, plugin, and workflow secure items from the operating-system keychain.

The current unpackaged Windows build cannot reliably request or report per-app capture permission, so startup reports native capture access as Not required without probing a device or the global desktop-app microphone switch. Capture features do not show Windows permission UI. If Windows or the selected device later prevents capture, the device-open attempt fails prompt-free; use the Windows microphone Settings link that is always available under Settings → Privacy & Data → Desktop access.

Each macOS Keychain item can have its own dialog. Allow permits only that read, while Always Allow remembers access for the current Wrengle app identity. The startup check only makes secrets available to the native Rust process for this app session: it does not contact a provider, refresh OAuth, run an action, start an agent, or begin recording.

If a supported startup access check is denied, Wrengle opens in Limited mode instead of interrupting you later. Local vault and note work remains available. The startup panel and Settings → Privacy & Data → Desktop access show which capabilities are unavailable and offer System Settings, Restart Wrengle, or an explicit retry where appropriate.

Open or create a vault

A vault is the local folder Wrengle uses for notes and app-managed metadata. Keep it somewhere you can back up.

Create a note

Use the file tree or command palette to create a note. The editor stores content as local files, with app metadata kept beside the vault.

Sign-in is optional and is not part of first-run setup. Use the account entry in the status bar if you want a Wrengle identity on this installation. The system browser handles sign-in, credentials stay in the operating-system keychain, and your vault remains local. See Accounts and sign-in.

Use the workspace

The main workspace has three core regions and an optional fourth:

the project/file tree;
the editor area;
the agent panel;
a far-right utility panel for History, Search, Backlinks, and contributed tools when one is open.

The agent and utility panels are independent. You can keep both open, and closing either panel leaves the other one in place.

Try Quick Dictation

Open Settings → Dictation → Microphone and voice setup, choose Dictation microphone, and use the five-second Test microphone action. The test stays local and does not start transcription. Then focus the note, hold Cmd+Shift+D on macOS or Ctrl+Shift+D on Windows, and release when you finish speaking. The voice panel should name the note as its destination and commit the current partial on release.

Speech and voice analysis default to Auto: a connected provider key confirmed available in the OS keychain selects its cloud route without another setup toggle, while an unavailable cloud route falls back to Local. Provider validity is checked when a request runs, so invalid, revoked, or quota-limited keys can still fail.

Configure the language, Verbatim or Light edit cleanup, and response speed under Dictation. Local speech keeps microphone audio on the device; cloud speech sends it to the effective provider. See Dictation and voice control before using voice commands or deciding which data boundary you want.

Try a workflow

Open Workflows from any New tab (+) menu or the command palette. Start with a blank workflow or a starter, then use Dry run to inspect it or Run to execute an autonomous-safe draft immediately. To run it on a daily or specific-days schedule, choose Automate…; Wrengle pins the current draft as the automation's live version. Read Workflows and automations before relying on scheduled behavior.

Read limitations before relying on a workflow

Wrengle is in beta. Review Known limitations before relying on dictation, voice commands, workflow automation, transcription, AI, plugins, or download/access behavior.