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

Reference

What leaves your Mac and security

Check which requests leave your Mac, where credentials stay, and what the app permits research tools to do.

Local records and remote requests#

DestinationWhat it receives
This MacChats, Sources, Map, Lens, Journal, holdings and research files
Your AI providerMessages and the Sources and saved notes used by answers or background reading
Data sourcesRequested names and tickers; public wallet addresses you add
Web servicesSearches and pages opened for research
A custom connectionThe requests its permitted tools make

Holdings quantities and values stay local in app-managed research context. Information you type into a message still goes to the selected AI provider. Private chat skips Memory reads and saves; it still saves chat history and sends messages to the provider.

There is no Loupist account, cloud sync, analytics or telemetry. The app contacts GitHub to check a signed update feed about once a day, sooner after failed checks.

Credentials#

Data connection secrets use the macOS Keychain. AI sign-ins and keys stay in private app storage on this Mac. Enter credentials only in the dedicated setup form. The app does not return them to the model or show them again in connection fields.

This is not protection from every same-user process on your Mac: other software running as you can still pose a risk to local data. Keep credentials and private research out of public bug reports.

Files, code and outside text#

Native file tools are limited to admitted workspace, scratch, attachments and bounded instruction locations. Credentials, private app data and Git metadata are refused. Bundled Skills are read-only. Files written inside an allowed folder can survive cancellation.

run_python has no shell, network or host environment. Its offline snapshot and output writes are bounded. A sandbox reduces access; it does not establish that every generated file is safe to run in another program.

Outside text can carry hidden instructions. After reading it, selected schedule, connection and instruction-file actions pause for the reply. A custom-connection result adds a broader outbound pause. The app explains the refused step; ask for a paused action in a later message.

Report a vulnerability#

Use GitHub private vulnerability reporting. Include the affected version, a minimal reproduction with fictional data and the observed impact. Do not put credentials or private research in public issues.

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