LoupistGitHubDownload

Loupist Docs

Search Loupist Docs

Browse all pages or type to search

Get startedOverviewLearn what a Loupist keeps, how it uses evidence, and where to begin your first research question.Get startedQuickstartInstall Loupist, connect an AI account, and check the evidence behind your first answer.Get startedInstall and verify the BetaInstall the macOS Beta and check that the download matches the public release workflow.Get startedConnect an AI accountConnect the account or API key that will answer your questions, and understand which work uses it.Get startedCreate a LoupistCreate a separate research companion with its own focus, conversations and Memory.Core conceptsHow a Loupist learnsFollow the path from a retained original to a method used in a later answer, and inspect what changed.Core conceptsMemory recordsTell retained evidence, analysis and your own judgments apart, and find each record in the app.Core conceptsWorld and MapTrace a relationship to its evidence, navigate your Map, and export an image or growth replay.Core conceptsLens and your principlesTeach a research rule, inspect pages built from evidence, and see why a learned method changed.GuidesFollow assets and import holdingsBuild the list your research uses, import a holdings snapshot, and distinguish following from automatic checks.GuidesWatching and alertsChoose automatic checks, inspect their source coverage, and pause or refresh them without an AI call.GuidesBriefings and ScheduleCreate timed research in Bot, inspect the result, and control future runs from Schedule.GuidesBot and research sessionsUse Bot for ongoing work and open a separate research session for a question that needs its own conversation.GuidesRead an answerCheck a finding against its original sources, inspect calculated figures, and distinguish a receipt from proof of correctness.GuidesRun calculations with run_pythonAsk for reproducible numerical work and inspect its code, files and limits.GuidesJournal entries and later reviewsRecord your own judgment with an optional dated check, then compare it with later evidence.GuidesPrivate chatTurn off Memory use and saving for a conversation while understanding what still persists and leaves your Mac.GuidesData connectionsSet up a built-in source or a custom read-only service and choose which Loupists may use it.GuidesMove or back up a LoupistPreserve a Loupist folder, reopen its saved identity, and know which shared settings need separate setup.ReferenceData sourcesFind the source for a research task and identify the setup or coverage to check before using it.ReferenceKeyboard and command paletteNavigate the app and find research without the mouse, with the current shortcut list available in Settings.ReferenceSettingsFind the right settings scope for accounts, defaults, appearance and a single Loupist.ReferenceWhat leaves your Mac and securityCheck which requests leave your Mac, where credentials stay, and what the app permits research tools to do.ReferenceUpdates and Beta limitsCheck for an update, understand version compatibility, and confirm the supported Beta platform.ReferenceTroubleshooting and FAQRecover from common setup, account, source and schedule problems without treating missing evidence as a successful check.ReferenceLicenceFind the terms for the app, distinguish them from data-provider rights, and keep private research separate from code licensing.

↑ ↓ navigate · Enter opens · Escape closes

Guides

Move or back up a Loupist

Preserve a Loupist folder, reopen its saved identity, and know which shared settings need separate setup.

Copy the whole folder#

  1. Open Loupist settings and use Open folder to locate the workspace.
  2. Quit Loupist before copying it.
  3. Copy the entire folder, including the hidden .loupist/ folder. Keep the original until the copy is verified.
  4. Open the copied folder through Open a Loupist folder and inspect its chats and retained originals.

The folder holds this Loupist's profile, research sessions, Memory, originals, datasets, artifacts, attachments and schedule definitions/history. Copying only visible reports or Lens Markdown is not a full backup.

Reconnect after a move#

If the app reports Workspace folder unavailable, choose Reconnect folder and locate the original or copied workspace. An empty folder cannot replace saved data. Reconnection preserves the saved identity and profile name.

A registered identity cannot be opened as a second independent Loupist. Removing its registration leaves the folder available to reopen; it does not delete the saved research.

What does not travel with it#

AI credentials, GitHub sign-in and disposable process caches stay in private app storage. Following and holdings are shared app-level state, rather than a separate copy inside each Loupist. A folder copy is therefore a backup of that Loupist, not a complete migration of every app setting or account.

Connect AI accounts and Data connections on the destination Mac as needed. Re-registered schedules and Map building are paused. Opening saved work does not itself grant permission for automatic execution; inspect those settings before resuming them.

Version compatibility#

Compatible data upgrades create a private backup beside the database before changing it. Older unsupported formats and data saved by a newer app can be refused and left unchanged. Saved by a newer version means you should update the app to open it.

There is no cloud or mobile sync and downgrading is not supported. Keep a separate folder copy before moving between app versions. See Updates and Beta limits.

Based on the app’s source documentation and English interface labels. Report a docs issue.